eu/jev: API di classificazione del testo in Germania

eu/jev è una API indipendente gestita da Bevelites GmbH. Permette agli sviluppatori di classificare contenuti, indirizzare richieste di assistenza e valutare opzioni con risposte strutturate.

A cosa serve eu/jev, in parole semplici

Se arriva un messaggio su un addebito errato, puoi descrivere le categorie «fatturazione» e «assistenza tecnica». Il sistema restituisce una scelta e le relative probabilità. Il Playground mostra questa interazione; usare il risultato nel gestionale ed eseguire l’azione successiva richiede la tua integrazione.

La prima richiesta di classificazione

Servono un account ammesso e una chiave del pannello. Le domande di accesso sono valutate in base alla capacità e il modulo non garantisce ammissione. Conserva la chiave sul server.

Inserisci il testo in state e una domanda con nome in questions. Per choice descrivi 2–10 opzioni. Invia JSON con POST a https://eu-jev.com/v1/systemone, autenticazione Bearer e Content-Type: application/json. Usa jeff-latest oppure una versione documentata come jeff-1.0.0. Prima controlla lo stato HTTP, poi answers.team.choice, probabilities e confidence.

L’esempio è ricavato dal formato pubblico, senza chiamata con chiave reale. State può essere anche un oggetto o array JSON. Non è pubblicato un elenco completo delle lingue: verifica quelle del progetto con esempi adatti.

La documentazione ufficiale include anche esempi HTTP in JavaScript e Python.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "La fattura contiene un addebito aggiuntivo. Serve una verifica.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Scegli il team che deve gestire il messaggio.",
      "criteria": {
        "billing": "Fatture, pagamenti e rimborsi",
        "technical": "Errori, interruzioni e accesso all’account"
      }
    }
  }
}'

Formato API ed errori

Tre risposte diverse per tre decisioni

Choice restituisce opzione, probabilità e confidence. La confidenza è normalizzata rispetto a una scelta uniforme e non coincide con la probabilità dell’opzione scelta. Noul restituisce una probabilità sì/no tra 0 e 1. Score usa 2–10 criteri ordinati e restituisce una posizione attesa tra 0 e N−1, con probabilità e legenda.

Verifica testi rappresentativi e casi ambigui contro risposte controllate prima di automatizzare. Trovi inoltre modello effettivo, token di ingresso, ID della richiesta e, se riuscita, costo esatto meta.cost_eur.

Crediti e tariffa sui token di ingresso

Verifica del 5 ottobre 2026, in EUR: gli account nuovi ammessi ricevono €5 di credito promozionale una tantum, senza rinnovo mensile o addebiti automatici. La tariffa è €37 per miliardo di token di ingresso, cioè €0,037 per milione. I token di uscita sono gratuiti.

Contesto, istruzioni, criteri e preparazione contano come ingresso; lo stato condiviso si conta una volta. Gli ingressi ripetuti o in cache hanno la stessa tariffa. Si addebitano solo risultati riusciti, con saldo comune al Playground autenticato. Se non basta, HTTP 402 insufficient_credits ferma l’inferenza. L’uso aggiuntivo si richiede tramite modulo; eventuali pagamenti richiedono un accordo espresso separato.

Tariffe e termini del servizio

Dove passano e restano i dati

Origine, database applicativo e processo del modello sono presso Hetzner in Germania, senza proxy esterno o CDN nel percorso di inferenza documentato. Input e risposte non sono salvati nel database o log applicativi né usati per training, ma le cache RAM possono restare tra richieste.

Dati di account, utilizzo, credito e sicurezza vengono conservati, senza cancellazione automatica per età dei record di account e uso. Login Google, email e modulo esterno possono coinvolgere trattamenti fuori SEE, inclusi gli USA. L’inferenza tedesca non descrive ogni flusso del servizio. L’uso aziendale di dati personali richiede una DPA; nel Playground anonimo usa dati sintetici o non personali.

I trattamenti sensibili o ad alto rischio richiedono condizioni scritte e garanzie separate; le decisioni importanti necessitano di un adeguato controllo umano.

Privacy e dati · DPA per uso aziendale

Dimensioni delle richieste e compatibilità

Chiavi e Playground autenticato condividono 60 richieste/minuto per account. Per visitatore anonimo sono 12/minuto e 100/giorno. Limiti API: 256 KiB JSON, 100.000 caratteri di state stringa, otto domande, 1.000 caratteri per istruzione e 500 per criterio serializzato. L’ingresso preparato deve rientrare in 32.768 posizioni, inclusi rami e formattazione. Il campo Playground ha un limite separato di 12.000 caratteri.

Le richieste sono elaborate una alla volta, chiavi prioritarie, con attesa in coda fino a 20 secondi. Rispetta Retry-After in 429/503 e rivedi gli input per 422. latency_ms non misura tutto il percorso di rete.

La compatibilità TypeSafe riguarda la struttura HTTP: ID Jev restituiscono 400, mentre SDK e risultati identici non sono garantiti. L’integrazione commerciale segue i termini; il modello base Winnow non rende aperto o auto-ospitabile il software di questo servizio.

Domande sull’uso dell’API

Che cosa restituisce una classificazione con eu/jev?

Restituisce scelte, probabilità binarie o punteggi ordinati a seconda della domanda, insieme ai metadati utili alla verifica.

Come inviare una richiesta con categorie personalizzate?

Descrivi i criteri in una domanda choice e usa il modello ospitato con una chiave valida. Il percorso documentato non richiede di allenare prima un modello tuo.

Che differenza c’è tra scelta, probabilità e punteggio?

Una scelta indica l’opzione selezionata; una probabilità quantifica la previsione; Score dipende dall’ordine dei criteri. Controlla i campi e valida con esempi, senza considerarli garanzie di correttezza.

Il credito iniziale si rinnova ogni mese?

No. I €5 sono una promozione una tantum per gli account ammessi. Le chiamate riuscite consumano il saldo alla tariffa dei token di ingresso; uso aggiuntivo e pagamenti richiedono un accordo separato.

L’inferenza in Germania riguarda tutti i dati dell’account?

No. Google, email e modulo possono comportare trattamenti fuori SEE. Per dati personali aziendali serve una DPA; la sede dell’inferenza non copre ogni flusso del servizio.

Risorse ufficiali

• FAQ e modello di base
• Richiesta di accesso o uso aggiuntivo