eu/jev: tekstclassificatie-API vanuit Duitsland

eu/jev is een onafhankelijke beslis-API van Bevelites GmbH. Ontwikkelaars kunnen er teksten mee indelen, klantvragen doorsturen of opties beoordelen op beschreven criteria.

Wat eu/jev doet, in gewone taal

Je ontvangt een bericht over een onjuiste factuur. Je beschrijft de categorieën facturatie en technische ondersteuning; eu/jev geeft een keuze en kansinformatie terug. Daarmee kan je toepassing bepalen welke route past. De Playground laat het principe zien. De koppeling met je ticketsysteem en de daadwerkelijke actie bouw je zelf.

Categorieën kiezen voor een echte werkstroom

Definieer heldere labels met representatieve voorbeelden en twijfelgevallen. Choice kiest uit 2–10 opties en geeft probabilities en confidence. Die confidence is genormaliseerd tegenover gelijkmatig raden en is niet de kans van de gekozen optie. Noul geeft een ja/nee-kans tussen 0 en 1; Score geeft de verwachte positie van 0 tot N−1 op 2–10 geordende criteria, met kansverdeling en legenda.

Een eerste API-verzoek opbouwen

Je hebt een toegelaten account en een dashboardsleutel nodig. Toegang wordt naar beschikbare capaciteit beoordeeld; het aanvraagformulier maakt geen account aan en garandeert geen toelating. Houd de sleutel op de server.

Zet de context in state en een benoemde vraag in questions. POST JSON naar https://eu-jev.com/v1/systemone met Bearer en Content-Type: application/json. Gebruik jeff-latest of een gedocumenteerde vaste versie zoals jeff-1.0.0. Controleer de HTTP-status en lees daarna answers.team.choice, probabilities en confidence. State mag ook een JSON-object of array zijn.

Het voorbeeld volgt de documentatie en is niet met een echte sleutel getest. Een volledige talenlijst is niet gepubliceerd: test je eigen taal en teksten.

De officiële documentatie bevat ook HTTP-voorbeelden voor JavaScript en Python.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "Op de factuur staat een extra afschrijving. Kunnen jullie dit controleren?",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Kies het team voor dit klantbericht.",
      "criteria": {
        "billing": "Facturen, betalingen en terugbetalingen",
        "technical": "Fouten, storingen en accounttoegang"
      }
    }
  }
}'

API-formaat en fouten

Voorspellingen beoordelen voordat je automatiseert

Vergelijk uitkomsten met gecontroleerde antwoorden, vooral bij onduidelijke berichten of weinig voorkomende labels. Een hoge score is geen gemeten nauwkeurigheid op je gegevens. Stel vast wanneer een mens moet beoordelen. De respons bevat ook de opgeloste modelversie, invoertokens, een verzoek-ID en bij succes de exacte kosten in meta.cost_eur.

Starttegoed en verbruikskosten

Gecontroleerd op 5 oktober 2026, in EUR: nieuwe toegelaten accounts krijgen eenmalig €5 promotietegoed, zonder maandelijkse aanvulling of automatische afschrijving. Het tarief is €37 per miljard invoertokens, dus €0,037 per miljoen; uitvoertokens zijn gratis.

Context, instructies, criteria en voorbereiding tellen mee; gedeelde state telt één keer. Herhaalde of gecachte invoer heeft hetzelfde tarief. Alleen succesvolle antwoorden verbruiken saldo, dat ook de ingelogde Playground gebruikt. Bij tekort stopt HTTP 402 insufficient_credits vóór inferentie. Extra gebruik vraag je via het formulier aan; betalen vereist een afzonderlijke uitdrukkelijke afspraak.

Tarief en gebruiksvoorwaarden

Duitse hosting en overige gegevensstromen

Origin, toepassingsdatabase en modelproces staan bij Hetzner in Duitsland, zonder externe modelproxy of CDN op het beschreven inferentiepad. Invoer en antwoorden worden niet in de toepassingsdatabase of logs opgeslagen en niet voor training gebruikt. RAM-caches kunnen echter meerdere verzoeken overleven.

Account-, gebruiks-, tegoed- en beveiligingsgegevens worden opgeslagen, zonder automatische leeftijdsgebonden verwijdering van account- en gebruiksrecords. Google-login, e-mail en het externe formulier kunnen verwerking buiten de EER omvatten, ook in de VS. Duitse inferentie betekent daarom niet dat ieder gegevenspad binnen de EU blijft. Zakelijk gebruik met persoonsgegevens vereist een DPA; gebruik in de anonieme Playground synthetische of niet-persoonlijke tekst.

Gevoelige verwerking of verwerking met hoog risico vereist afzonderlijke schriftelijke voorwaarden en waarborgen; ingrijpende beslissingen vragen passende menselijke controle.

Privacy en gegevensstromen · DPA voor zakelijk gebruik

Grenzen bij integratie

Sleutels en ingelogde Playground delen 60 verzoeken/minuut per account. Anoniem gelden 12/minuut en 100/dag per bezoeker. API-grenzen: 256 KiB JSON, 100.000 tekens string-state, acht vragen, 1.000 tekens per instructie en 500 per geserialiseerd criterium. Voorbereide invoer moet ook in 32.768 contextposities passen, inclusief vertakkingen en opmaak. Het Playground-tekstveld is beperkt tot 12.000 tekens.

Verzoeken worden één voor één verwerkt, sleutelverzoeken eerst, met maximaal 20 seconden wachttijd in de rij. Volg Retry-After bij 429/503 en pas invoer aan bij 422. latency_ms is geen volledige netwerkmeting. TypeSafe-compatibiliteit betreft het HTTP-formaat: Jev-modelnamen geven 400; gelijke SDK-werking en antwoorden zijn niet gegarandeerd. Commerciële integratie volgt de voorwaarden; Winnow als basismodel maakt de dienst niet open source of zelf te hosten.

Veelgestelde vragen over classificatie

Wat doet eu/jev met een tekst?

Het geeft tekst een categorie of een ander gestructureerd oordeel. Je toepassing gebruikt het resultaat voor een eigen vervolgstap.

Heb ik voor classificatie een eigen getraind model nodig?

De gedocumenteerde route gebruikt het gehoste model met beschreven categorieën. Zelf trainen is daarin geen voorwaarde; valideer wel met voorbeelden.

Hoe controleer ik een voorspelde categorie voordat ik die gebruik?

Vergelijk de voorspelling met gecontroleerde antwoorden en beoordeel twijfelgevallen. Probabiliteit en confidence zijn geen garantie dat een belangrijk besluit klopt.

Wordt het starttegoed elke maand aangevuld?

Nee. Toegelaten accounts krijgen eenmalig €5. Geslaagde verzoeken verbruiken het saldo volgens de prijs voor invoertokens; extra gebruik en betalingen vereisen een afzonderlijke overeenkomst.

Betekent Duitse hosting dat alle accountgegevens in de EU blijven?

Nee. Google-login, e-mail en het formulier kunnen verwerking buiten de EER omvatten. Zakelijke verwerking van persoonsgegevens vereist een DPA, ook bij Duitse inferentie.

Officiële bronnen

• Officiële FAQ en model
• Toegang of extra gebruik aanvragen