Jev API Docs

Endpoint

Senden Sie POST /api/v1/decisions an diesen Host. Es gibt keinen chat-completions-Pfad und kein Streaming. GET /api/v1/models listet die Modell-ID.

POST https://jev-api.org/api/v1/decisions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Authentifizierung

Setzen Sie den Dashboard-Schlüssel in Authorization: Bearer. Ein fehlender oder abgelehnter Schlüssel ergibt 401. Der Playground legt beim Ausführen einen Schlüssel für das Konto an.

Schnellstart

Setzen Sie JEV_API_KEY auf einen Schlüssel aus Ihrem Dashboard und senden Sie die Anfrage unten. Neue Konten erhalten 2 Credits, genug für 2 erfolgreiche Aufrufe.

curl https://jev-api.org/api/v1/decisions \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jev-1.13",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}'

Mit KI-Coding-Tools verwenden

Kopieren Sie einen Prompt mit dem vollständigen Anfragevertrag und fügen Sie ihn zusammen mit Ihrer Aufgabe in Cursor, Claude Code oder ChatGPT ein. Dieselbe Referenz liegt unter /llms.txt.

Anfrage-Body

model ist jev-1.13 oder jev-latest. state ist ein String, JSON-Objekt oder Textarray, bis 60.000 Zeichen. questions ist eine Map von 1 bis 6 snake_case-IDs. Die ID ist nur das Label, unter dem Ihre Antwort zurückkommt, keine Frage. Die echte Frage steht in instructions als Text von 1 bis 2.000 Zeichen.

{
  "model": "jev-1.13",
  "state": "Thanks for the refund. Still annoyed it took three emails.",
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "What is the overall sentiment of this message?",
      "criteria": {
        "positive": "Satisfied or thankful overall.",
        "mixed": "Both satisfied and unhappy.",
        "negative": "Unhappy overall."
      }
    },
    "needs_follow_up": {
      "type": "noul",
      "instructions": "Should a person reply to this message?"
    }
  }
}

Fragetypen

Noul

type noul braucht nur instructions. Das Feld noul ist die Wahrscheinlichkeit von 0 bis 1, dass die Aussage wahr ist. Es gibt kein separates confidence-Feld. Senden Sie criteria bei einer noul-Frage, ignoriert dieser Endpoint es.

Choice

type choice braucht instructions und criteria: ein Objekt von 2 bis 8 snake_case-IDs, jeweils mit einer Beschreibung von bis zu 300 Zeichen. Die Antwort enthält choice, probabilities jeder Option und confidence.

Score

type score braucht instructions und criteria als geordnetes Array von 2 bis 10 Stufen, die niedrigste zuerst. Die Antwort enthält score, legend, probabilities und confidence.

Antwort

Ein erfolgreicher Body hat model, answers unter Ihren Frage-IDs, usage mit input_tokens und output_tokens, und credits_used. model meldet jev-1.13, auch wenn Sie jev-latest gesendet haben. Unten eine Beispielantwort auf die Schnellstart-Anfrage, usage ausgelassen.

{
  "model": "jev-1.13",
  "answers": {
    "sentiment": {
      "type": "choice",
      "choice": "mixed",
      "probabilities": { "mixed": 0.79, "negative": 0.2, "positive": 0.01 },
      "confidence": 0.61
    },
    "needs_follow_up": { "type": "noul", "noul": 0.83 }
  },
  "credits_used": 1
}

Wahrscheinlichkeiten und confidence lesen

Noul ist die Wahrscheinlichkeit, dass die Aussage in instructions wahr ist. Choice und Score liefern eine Wahrscheinlichkeit je Option oder Stufe, plus confidence.

Der Zweite ist das Signal zur Übergabe. Wenn confidence niedrig ist oder zwei Optionen nah beieinander liegen, geben Sie den Fall an eine Person oder stellen Sie eine genauere Frage. Senken Sie den Cutoff nicht, bevor Sie diese knappen Fälle gesehen haben.

Limits

Unterschiede zu TypeSafes API

TypeSafe AI stellt Jev unter POST https://api.typesafe.ai/v1/systemone mit einem TypeSafe-Schlüssel bereit und rechnet pro Eingabe-Token ab. Der Anfrage-Body hier hat dieselbe Form: model, state und questions vom Typ noul, choice oder score. Was sich ändert:

• Pfad und Schlüssel: POST /api/v1/decisions auf jev-api.org, mit einem Schlüssel aus dem Dashboard dieser Website. TypeSafe-Schlüssel funktionieren hier nicht, und Schlüssel dieser Website funktionieren nicht bei TypeSafe.
• Modell-ID: senden Sie jev-1.13 oder jev-latest. Eine versionierte ID wie jev-1.13.0 ergibt 422.
• Limits: 1 bis 6 Fragen pro Aufruf und 2 bis 8 Choice-Optionen. TypeSafe dokumentiert bis zu 255 Choice-Optionen.
• Felder: instructions muss Text sein, und jede Choice-Option braucht eine Beschreibung. TypeSafe akzeptiert außerdem Objekt- oder Array-instructions und null-Optionsbeschreibungen.
• Abrechnung: 1 Credit pro erfolgreichem Aufruf, unabhängig von der Token-Zahl.

Fehler

• 401 — fehlender oder abgelehnter API-Schlüssel.
• 402 — der Schlüssel ist gültig, das Guthaben reicht nicht. Ein Upstream-Fehler verbraucht kein Credit.
• 422 — der Body hat die Prüfung nicht bestanden. Die Meldung nennt das Feld.
• 429 — der Entscheidungsdienst ist begrenzt. Später erneut versuchen.
• 502 — der Dienst hat keine Antworten geliefert. Es wird kein Credit verwendet.