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 ausstellenAuthentifizierung
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/judge | Führe ein Urteil aus. Abgerechnet über die Eingabe-Token dieses Aufrufs, und erst nach Erfolg. Fehler stromaufwärts werden nicht berechnet. |
GET /v1/me | Aktueller Nutzer, Guthaben und Gesamtausgaben. |
GET /v1/usage | Guthaben, Gesamtausgaben und jüngste Abrechnungsposten. |
Request-Body (/v1/judge)
state | Der zu beurteilende Text, 8–4000 Zeichen. |
questions | Bis zu 6 Fragen; Schlüssel müssen mit Kleinbuchstaben beginnen. |
Fragetypen
noul | Relevanz, gibt eine Gleitkommazahl 0–1 zurück. |
confidence | Konfidenz, gibt eine Gleitkommazahl 0–1 zurück. |
choice | Wä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
}cents | Restguthaben auf den nächsten Cent gerundet. usd und microUsd sind exakt. |
usd | USD-String. Kleine Beträge behalten Mikrodollar-Stellen. |
microUsd | Verbleibende Mikrodollar. 1 USD = 1,000,000. |
inputTokensLeft | Eingabe-Token, die dieses Guthaben bei $0.042 pro Million noch deckt. |
Fehler
| Status | error | |
|---|---|---|
401 | unauthorized / invalid_api_key | API Key fehlt oder ist ungültig. |
400 | invalid_request | state zu kurz oder keine Fragen. |
429 | quota_exceeded | Zu wenig Guthaben; enthält retry-after. |
502 | upstream_unavailable | Urteil-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
- Ein Urteil versuchenSchreibe einen Zustand und lies die Antwort.
- LiveTetris, sechs schnelle Urteile und eine Sortierung. Kopiere den Aufruf und führe ihn erneut aus.
- LaborSupport-Triage, Release-Review und mehr — bearbeiten und sofort ausführen.
- Vergleichclavue-jev und jev-1.13.0 beantworten dieselbe Frage.
- DemosUrteil-Beispiele, die du bearbeiten kannst.
- PreiseEingabe kostet $0.042 pro Million Token. Ausgabe ist kostenlos.
Doku
- EinführungWofür dieses Modell da ist.
- SchnellstartDas kleinste lauffähige Beispiel.
- System OneHier geschrieben: ein Zustand plus eine typisierte Frage. Das Modell ist clavue-jev.
- ZustandDer Text, den du sendest.
- KonfidenzWie sicher die Antwort ist und wann man darauf handelt.
- ChoiceWähle eine von mehreren sich ausschließenden Optionen.
- NoulEine Ja/Nein-Frage, zurückgegeben als Wahrscheinlichkeit für Ja.
- ScoreEntlang einer Skala bewerten.
- Absichts-RoutingEin Choice-Aufruf leitet die Anfrage weiter.
- Konfidenz-RoutingBei hoher Konfidenz handeln, bei niedriger übergeben.
- Fan-outMehrere Fragen zu einem Zustand.
- Zusammengesetztes ScoringMehrere Scores zu einem Ranking verrechnen.
- HTTP APIDie Anfrageform ohne SDK.
- Python SDKEin Urteil aus Python aufrufen.
- JavaScript SDKEin Urteil aus JavaScript aufrufen.
Fälle
- AnwendungslandkarteWelche Primitive wofür genutzt werden.
- LeitplankenEine Ja/Nein-Prüfung, bevor eine Aktion läuft.
- FunktionsaufrufPer Urteil entscheiden, welche Funktion aufgerufen wird.
- Klassifizieren mit KonfidenzNicht handeln, wenn die Klasse unsicher ist.
- Semantische SucheDie passenden Passagen finden.
- Parallele FragenDen ganzen Satz in einem Aufruf fragen.
- Hierarchische KlassifikationErst grobe Klasse, dann die feine.
- Zitat-PrüfungOb ein Satz durch die Quelle gestützt wird.
- EntitätsabgleichOb zwei Namen dasselbe bezeichnen.
- Skill-VorschlagAus den Kandidaten den passenden Skill wählen.
Mehr auf dieser Site
- Site-VerzeichnisDie vollständige Liste der Seiten oben.
- ÖkosystemCommunity-Projekte nach Kategorie.
- Jev-CoverageJeder Eintrag nennt Entscheidung und Beleg.
- Tägliche FälleJeden Tag die nächste Gruppe aus dem Korpus.
- CommunityÖffentliche Beiträge, jeder mit Quelle.
- BuildsNotizen zu Modell- und Site-Updates.
- PrimitiveChoice, Noul und Score zusammen.
- MusterRouting, Fan-out und zusammengesetztes Scoring.
- SDKsHTTP, Python und JavaScript.