API

API

Rufe Urteile mit einem API Key aus deinem Programm ab. Bei der Anmeldung gibt es $$5.00 Guthaben. Wie bei jev-1.13.0: nur Eingabe-Token, $$0.042 pro Million, Ausgabe kostenlos.

Stelle einen Key auf deiner Kontoseite aus. Der Klartext wird einmal angezeigt; der Server behält nur seinen sha256.

Key auf der Kontoseite ausstellen

Authentifizierung

Jede /v1/*-Anfrage braucht einen Bearer Key. Nur Keys – Session-Cookies werden nicht akzeptiert, damit Browser-Anmeldung und abgerechnete Aufrufe getrennt bleiben.

Authorization: Bearer jev_...

Endpunkte

POST /v1/judgeFühre ein Urteil aus. Abgerechnet über die Eingabe-Token dieses Aufrufs, und erst nach Erfolg. Fehler stromaufwärts werden nicht berechnet.
GET /v1/meAktueller Nutzer, Guthaben und Gesamtausgaben.
GET /v1/usageGuthaben, Gesamtausgaben und jüngste Abrechnungsposten.

Request-Body (/v1/judge)

stateDer zu beurteilende Text, 8–4000 Zeichen.
questionsBis zu 6 Fragen; Schlüssel müssen mit Kleinbuchstaben beginnen.

Fragetypen

noulRelevanz, gibt eine Gleitkommazahl 0–1 zurück.
confidenceKonfidenz, gibt eine Gleitkommazahl 0–1 zurück.
choiceWähle eine Option und gib den gewählten String zurück. Sende ein options-Array oder ein criteria-Objekt; options werden vor dem Modell in criteria überführt.

Antwort

Guthaben nach diesem Aufruf.

{
  "id": "k3f9a1c2b4d5",
  "model": "clavue-jev",
  "answers": {
    "relevance":  { "noul": 0.92 },
    "confidence": { "noul": 0.78 },
    "severity":   { "choice": "medium" }
  },
  "credit": { "cents": 500, "usd": "5.00", "microUsd": 5000000, "inputTokensLeft": 119047619 }
}

Das credit-Objekt

{
  "cents": 500,
  "usd": "5.00",
  "microUsd": 5000000,
  "inputTokensLeft": 119047619
}
centsRestguthaben auf den nächsten Cent gerundet. usd und microUsd sind exakt.
usdUSD-String. Kleine Beträge behalten Mikrodollar-Stellen.
microUsdVerbleibende Mikrodollar. 1 USD = 1,000,000.
inputTokensLeftEingabe-Token, die dieses Guthaben bei $0.042 pro Million noch deckt.

Fehler

Statuserror
401unauthorized / invalid_api_keyAPI Key fehlt oder ist ungültig.
400invalid_requeststate zu kurz oder keine Fragen.
429quota_exceededZu wenig Guthaben; enthält retry-after.
502upstream_unavailableUrteil-Backend ist nicht erreichbar. Keine Abrechnung.

Beispiel

curl https://api.jevcode.ai/v1/judge \
  -H "Authorization: Bearer jev_..." \
  -H "Content-Type: application/json" \
  -d '{
    "state": "The build failed on the second job, then passed after a retry.",
    "questions": {
      "relevance":   { "type": "noul",       "instructions": "Is this about CI?" },
      "confidence":  { "type": "confidence", "instructions": "How sure are you?" },
      "severity":    { "type": "choice",     "instructions": "Pick one.",
                       "options": ["low", "medium", "high"] }
    }
  }'

Auf dieser Seite weiter

Test, Doku, Fälle und Preise verlinken einander. Die nächste Seite liegt auf dieser Site.

clavue-jev nutzen

Doku

Fälle

Mehr auf dieser Site