eu/jev: API für Textklassifikation aus Deutschland

eu/jev ist eine eigenständige Entscheidungs-API von Bevelites GmbH. Entwickler können damit Texte einordnen, Supportanfragen weiterleiten oder Optionen anhand vorgegebener Kriterien bewerten.

Textklassifikation mit eu/jev verständlich erklärt

Stellen Sie sich eine Nachricht über eine fehlerhafte Rechnung vor. Sie beschreiben die Kategorien „Abrechnung“ und „Technischer Support“. eu/jev liest den Kontext und liefert eine Auswahl mit Wahrscheinlichkeiten, die Ihre Anwendung weiterverarbeiten kann.

Im Playground lässt sich das Prinzip ansehen. Für die Einbindung verwenden Sie die API; die Verbindung zum Ticketsystem und die tatsächliche Weiterleitung müssen Sie selbst umsetzen.

Eigene Kategorien als API-Fragen beschreiben

Voraussetzung sind ein zugelassener Account und ein API-Schlüssel aus dem Dashboard. Anträge werden nach verfügbarer Kapazität geprüft; das Formular garantiert keinen Zugang. Bewahren Sie den Schlüssel serverseitig auf.

Legen Sie den Text in state ab und benennen Sie eine Frage in questions. Für choice beschreiben Sie 2–10 Optionen. Senden Sie JSON mit Bearer-Authentifizierung und Content-Type: application/json per POST an https://eu-jev.com/v1/systemone. jeff-latest folgt der aktuellen Version; eine dokumentierte Version wie jeff-1.0.0 lässt sich fest angeben.

Das Beispiel basiert auf dem öffentlichen Format, wurde aber nicht mit einem echten Schlüssel ausgeführt. Prüfen Sie zuerst den HTTP-Status und danach answers.team.choice, probabilities und confidence. State kann auch ein JSON-Objekt oder Array sein. Eine vollständige Sprachliste ist nicht veröffentlicht; testen Sie Ihre Sprache mit passenden Beispielen.

Die offizielle Dokumentation enthält auch HTTP-Beispiele für JavaScript und Python.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "Eine Rechnung enthält eine weitere Abbuchung. Bitte prüfen.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Wähle das zuständige Team für diese Nachricht.",
      "criteria": {
        "billing": "Rechnungen, Zahlungen und Erstattungen",
        "technical": "Fehler, Ausfälle und Kontozugang"
      }
    }
  }
}'

API-Dokumentation und Fehlerbehandlung

Ergebnisse und Wahrscheinlichkeiten prüfen

Choice gibt die gewählte Option, ihre Wahrscheinlichkeiten und confidence zurück. Die Konfidenz wird gegenüber gleichmäßigem Raten normiert und ist nicht die Wahrscheinlichkeit der gewählten Option. Noul liefert eine Ja/Nein-Wahrscheinlichkeit zwischen 0 und 1. Score verarbeitet 2–10 geordnete Kriterien und liefert eine erwartete Position von 0 bis N−1 mit Wahrscheinlichkeiten, Konfidenz und Legende.

Vergleichen Sie Vorhersagen mit geprüften Antworten aus Ihrem Einsatzgebiet. Auch unklare Nachrichten gehören in den Test. Modellversion, Eingabetokens, Anfrage-ID und bei Erfolg meta.cost_eur helfen, Antworten und Kosten nachzuvollziehen.

Datenverarbeitung in Deutschland einordnen

Origin, Anwendungsdatenbank und Modellprozess laufen bei Hetzner in Deutschland. Der dokumentierte Inferenzpfad enthält keinen externen Modellproxy oder CDN. Eingaben und Antworten werden nicht in der Anwendungsdatenbank oder den Anwendungslogs gespeichert und nicht fürs Training genutzt. Zwischendaten im RAM können dennoch mehrere Anfragen überdauern.

Account-, Nutzungs-, Guthaben- und Sicherheitsdaten werden gespeichert; für Account- und Nutzungsdaten gibt es keinen automatischen altersbasierten Löschjob. Google-Anmeldung, E-Mails und das externe Formular können Verarbeitung außerhalb des EWR einschließlich der USA betreffen. „Inferenz in Deutschland“ beschreibt daher nicht sämtliche Datenflüsse. Für geschäftliche Verarbeitung personenbezogener Daten ist eine DPA erforderlich; im anonymen Playground sollten synthetische oder nicht personenbezogene Inhalte stehen.

Sensible oder risikoreiche Verarbeitung braucht gesonderte schriftliche Bedingungen und Schutzmaßnahmen; folgenreiche Entscheidungen erfordern angemessene menschliche Prüfung.

Datenschutz und Datenverarbeitung · DPA für geschäftliche Nutzung

Startguthaben und Abrechnung verstehen

Stand 5. Oktober 2026, in Euro: zugelassene neue Accounts erhalten einmalig €5 Werbeguthaben. Es wird nicht monatlich erneuert und führt nicht zu automatischen Abbuchungen. Der Satz beträgt €37 je Milliarde Eingabetokens, also €0,037 je Million; Ausgabetokens sind kostenlos.

Kontext, Anweisungen, Kriterien und Vorbereitungstokens zählen als Eingabe. Geteilter Kontext zählt einmal, weitere Frageeingaben zusätzlich; wiederholte oder gecachte Eingaben kosten denselben Satz. Nur erfolgreiche Ergebnisse verbrauchen Guthaben. Angemeldete Playground-Aufrufe nutzen das gleiche Konto. Reicht das Guthaben nicht, stoppt die Anfrage mit HTTP 402 insufficient_credits vor der Inferenz. Mehr Nutzung wird über das Formular beantragt; eine Bezahlung setzt eine gesonderte ausdrückliche Vereinbarung voraus.

Abrechnung und Nutzungsbedingungen

Grenzen beim produktiven Einsatz

Alle Schlüssel und angemeldeten Playground-Aufrufe teilen 60 Anfragen pro Minute je Account. Anonym gelten 12 pro Minute und 100 pro Tag je Besucher. Das API-Limit umfasst 256 KiB JSON, 100.000 Zeichen für String-state, acht Fragen, 1.000 Zeichen je Anweisung und 500 je Kriterium nach Serialisierung. Der vorbereitete Kontext muss zusätzlich in 32.768 Positionen passen; der Playground begrenzt das Textfeld separat auf 12.000 Zeichen.

Anfragen werden einzeln abgearbeitet, Schlüsselanfragen zuerst. Unter Last kann die Wartezeit in der Queue bis zu 20 Sekunden betragen. Beachten Sie Retry-After bei 429 und voller Queue mit 503; kürzen Sie problematische Eingaben bei 422. latency_ms ist keine Ende-zu-Ende-Messung.

TypeSafe-Kompatibilität betrifft nur die HTTP-Struktur. Jev-Modellnamen führen zu 400; identische Ergebnisse und SDK-Kompatibilität sind nicht zugesichert. Kommerzielle Einbindung unterliegt den Nutzungsbedingungen. Ein offenes Winnow-Basismodell bedeutet keine Open-Source- oder Selbsthosting-Lizenz für diesen Dienst.

Fragen zur Integration

Wofür eignet sich eu/jev zur Textklassifikation?

Für kontextabhängige Kategorien, Support-Zuordnung und Bewertungen anhand beschriebener Kriterien. Die Anwendung muss den Rückgabewert mit dem weiteren Ablauf verbinden.

Muss ich für die API ein eigenes Modell trainieren?

Der dokumentierte Weg nutzt das vorhandene Modell und im Aufruf beschriebene Kategorien. Eigene Trainingsschritte sind dafür nicht vorgesehen; passende Tests bleiben erforderlich.

Wie prüfe ich die Klassifikation mit eigenen Beispielen?

Vergleichen Sie typische und schwierige Texte mit geprüften Antworten. Konfidenz ersetzt weder gemessene Genauigkeit auf Ihren Daten noch die Prüfung wichtiger Entscheidungen.

Wird das Startguthaben jeden Monat erneuert?

Nein. Zugelassene Konten erhalten einmalig €5, kein monatliches Kontingent. Erfolgreiche Aufrufe verbrauchen Guthaben zum veröffentlichten Eingabetokenpreis; weitere Nutzung und Zahlungen benötigen eine gesonderte Vereinbarung.

Bleiben mit deutscher Inferenz sämtliche Kontodaten in der EU?

Nein. Google-Anmeldung, E-Mails und das externe Formular können Verarbeitung außerhalb des EWR betreffen. Für geschäftliche personenbezogene Daten ist zusätzlich eine DPA nötig.

Offizielle Anlaufstellen

• Offizielle FAQ und Modellhintergrund
• Zugang oder zusätzliche Nutzung beantragen