Die Jev API erhält einen state und benannte, typisierte Fragen. Die Antworten verwenden dieselben Namen. Mit einer kleinen Dringlichkeitsprüfung lernen Sie zuerst eine einzelne Entscheidung kennen. Das Anfrageformat folgt der offiziellen Dokumentation; ein Live-Test mit einem eigenen API-Schlüssel dieser Website wurde nicht durchgeführt.

1. Zugang erhalten und Schlüssel schützen

Öffnen Sie den offiziellen Playground oder melden Sie sich in der Konsole an, um einen API-Schlüssel zu erhalten. Prüfen Sie Modellzugang und Abrechnungsbedingungen. Speichern Sie TYPESAFE_API_KEY als Umgebungsvariable oder serverseitiges Secret, niemals in einer öffentlichen Webseite, einem Repository oder einem Browser-Bundle.

Offizielle Zugänge: Playground · API keys

2. Eine kleine Anfrage senden

Das cURL-Beispiel liest die Umgebungsvariable und fixiert jev-1.13.0 als nachvollziehbare Version. Zustand und Frage bleiben in allen Übersetzungen Englisch; andere Sprachen müssen separat evaluiert werden. Beim Ausführen mit Ihrem Schlüssel entsteht eine echte, möglicherweise kostenpflichtige Anfrage.

curl --fail-with-body --max-time 30 \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "model": "jev-1.13.0",
  "state": "Our payment integration has failed for three days. Please help ASAP.",
  "questions": {
    "urgency": {
      "type": "noul",
      "instructions": "Does this message express urgency?"
    }
  }
}
JSON

3. Die Antwort lesen

Lesen Sie answers.urgency.noul. Noul ist die Wahrscheinlichkeit für Ja, kein Textlabel. model nennt die tatsächliche Version und usage.input_tokens hilft bei der Kostenmessung. Der folgende Ausschnitt ist illustrativ und keine aufgezeichnete API-Antwort. Ihr Wert kann abweichen.

Illustrativer Antwortausschnitt:

{
  "model": "jev-1.13.0",
  "answers": {
    "urgency": {
      "type": "noul",
      "noul": 0.94
    }
  }
}

4. Die nächste Aktion bestimmen

Prüfen Sie Typ und Wertebereich. Eine Beispielregel könnte Werte ab 0,8 in die dringende Warteschlange leiten und andere normal oder manuell prüfen. Diese Grenze ist kein offiziell sicherer Standard. Bestimmen Sie sie aus gelabelten Daten und den Kosten von Fehlalarmen und übersehenen Fällen. Zugriffskontrollen bleiben verbindlich.

5. Choice oder Score ergänzen

Für Teams nutzen Sie Choice mit klaren criteria für Abrechnung, Technik, Vertrieb und einen Ausweichpfad. Für geordnete Bewertungen nutzen Sie Score mit Beschreibungen je Stufe. Beide liefern Verteilungen und confidence. Noul liefert eine Ja-Wahrscheinlichkeit; erwarten Sie nicht dasselbe confidence-Feld.

6. Fehler und Änderungen behandeln

Bei Authentifizierungsfehlern prüfen Sie Header, Schlüssel und Zugriff; bei ungültigen Anfragen JSON und Schema. Beachten Sie bei 429 den Header retry-after, sofern vorhanden, und begrenztes Backoff. Offizielle SDKs bieten Wiederholungen. Setzen Sie Timeouts, halten Sie Seiteneffekte idempotent und behandeln Sie ungültige Antworten als Prüffälle. Evaluieren Sie Schwellen vor einem Modellwechsel erneut.

Weiterlesen

Überblick · Anwendungsfälle · Preise · Grenzen

Quellen und weitere Informationen