Jev API: Zugang, Requests und SDKs
Die Jev-API besteht aus einem Endpoint: Sie senden einen Zustand und typisierte Fragen und lesen typisierte Antworten mit ihren Wahrscheinlichkeiten. Hier finden Sie das Format, einen Request-Builder und die offiziellen SDKs.
Die Jev API kurz erklärt: ein Endpoint, ein Zustand, Fragen
Alles läuft über eine HTTP-POST-Anfrage, die mit einem API-Schlüssel authentifiziert wird (Header Authorization: Bearer). Der Body enthält das Modell (jev-latest), den Zustand, den Jev lesen soll, und ein Dictionary von Fragen. Die Antwort enthält je Frage eine typisierte Antwort und die Token-Nutzung.
POST https://api.typesafe.ai/v1/systemone
Authorization: Bearer <API_KEY>
Content-Type: application/json
{ "model": "jev-latest", "state": "...", "questions": { ... } }Den Schlüssel erstellen Sie in der TypeSafe-Konsole. Das Format von Anfrage und Antwort ist im offiziellen Quickstart und in der API-Referenz beschrieben.
Die drei Fragetypen der Jev API: Noul, Choice und Score
Jede Frage hat einen Typ, der die Form der Antwort festlegt. Sie können mehrere Fragen zum selben Zustand in einer Anfrage stellen: Sie werden parallel ausgewertet, und zusätzliche Fragen kosten nur die zusätzlichen Input-Tokens.
Anfrage
{
"type": "noul",
"instructions": "The message conveys\n urgency or time-sensitivity"
}Antwort
{
"type": "noul",
"noul": 1.0
}Ein Noul beantwortet eine Ja/Nein-Frage mit der Wahrscheinlichkeit, dass die Aussage zutrifft. Nützlich für Flags wie dringend, Spam, themenfremd oder Jailbreak-Versuch.
Anfrage
{
"type": "choice",
"instructions": "Which team should\n handle this",
"criteria": {
"billing": "Payment issues",
"technical": "Bugs, integrations",
"sales": "Pricing questions"
}
}Antwort
{
"type": "choice",
"choice": "technical",
"confidence": 0.78,
"probabilities": {
"technical": 0.85,
"sales": 0.0,
"billing": 0.15
}
}Ein Choice wählt eine der von Ihnen definierten Optionen und liefert eine Wahrscheinlichkeit je Option sowie eine Gesamtkonfidenz. Jev unterstützt bis zu 255 Optionen pro Frage.
Anfrage
{
"type": "score",
"instructions": "How frustrated the\n customer appears",
"criteria": [
"Calm, just stating facts",
"Frustrated but civil",
"Very angry, strong language"
]
}Antwort
{
"type": "score",
"score": 1.0,
"confidence": 1.0,
"legend": { "0": "Calm...",
"1": "Frustrated...", "2": "Very angry..." },
"probabilities": { "0": 0.0, "1": 1.0, "2": 0.0 }
}Ein Score bewertet den Zustand auf geordneten Stufen, die Sie beschreiben. Sie erhalten einen kontinuierlichen Score, die Verteilung über die Stufen und einen Konfidenzwert, praktisch für Composite Scoring im Code.
Jev Request-Builder: JSON, cURL und Python
Stellen Sie eine Jev-Anfrage zusammen und kopieren Sie sie als JSON, cURL oder Python. Es wird nichts gesendet: Diese Website ruft die Jev-API nie auf. Zum Ausführen verwenden Sie einen API-Schlüssel aus der TypeSafe-Konsole.
Jev SDKs: Python, JavaScript und LangChain
# Python 3.10+ pip install typesafe-sdk from typesafe_sdk import Noul, TypeSafeClient client = TypeSafeClient() # liest TYPESAFE_API_KEY res = client.system_one( state="Der Checkout schlägt seit 9 Uhr für alle Kunden fehl.", questions={"urgent": Noul(instructions="Needs attention right now")}, ) print(res.answers["urgent"].noul)
pip install langchain-typesafe # TYPESAFE_API_KEY setzen, dann: from langchain_typesafe import Noul, TypeSafeClassifier clf = TypeSafeClassifier() res = clf.invoke({ "state": "Deploy failed twice, customers see 500s.", "questions": {"urgent": Noul(instructions="Needs attention now")}, }) print(res.nouls["urgent"].noul)
# Claude Code claude plugin marketplace add typesafe-ai/skills claude plugin install typesafe@typesafe-ai # Andere Coding-Agenten npx skills add typesafe-ai/skills --skill typesafe-ai
choice(), score() und noul(). Installationsanleitung und vollständige Referenz finden Sie in der Dokumentation des JavaScript-SDK, der Quellcode liegt auf GitHub.Es gibt außerdem system-one-adapter-python, einen kompatiblen Client, der dieselben System-One-Anfragen über LLM-APIs ausführt, praktisch, um Jev mit einem Allzweckmodell zu vergleichen.
So erhalten Sie einen Jev-API-Schlüssel
- Melden Sie sich für den Early Access auf typesafe.ai an. Jev ist im Early Access: TypeSafe lässt Entwickler von seiner Warteliste zu.
- Öffnen Sie die TypeSafe-Konsole und erstellen Sie einen Schlüssel auf der Seite der API-Schlüssel.
- Senden Sie Ihre erste Anfrage aus dem Playground oder mit cURL, Python oder LangChain.
Best Practices für die Integration von Jev: vier Muster
TypeSafe empfiehlt, den Code die Kontrolle behalten zu lassen und Jev nur enge, strukturierte Entscheidungen zu übertragen. Vier Muster tauchen in der Dokumentation immer wieder auf.
Spekulatives Fan-out
Senden Sie mehrere Fragen in einem Aufruf, auch spekulative, und lassen Sie Ihren Code entscheiden, was relevant ist. Das Cookbook „Parallel Questions“ von TypeSafe misst einen gebündelten Aufruf mit 13 Fragen als 12,2-mal günstiger und 10-mal schneller als getrennte Aufrufe, ohne Änderung der Antworten.
Konfidenz-Routing
Nutzen Sie die Konfidenz als zweite Achse: Die Antwort sagt was, die Konfidenz sagt, ob gehandelt werden soll. Unsichere Fälle gehen an einen Menschen oder ein stärkeres Modell.
Composite Scoring
Zerlegen Sie ein komplexes Urteil in atomare Scores und kombinieren Sie sie mit Gewichten, die Sie im Code steuern.
Intent-Routing
Klassifizieren Sie eingehende Anfragen und leiten Sie jede an den besten Handler: deterministische Logik, spezialisiertes LLM oder Mensch.
Weiterlesen zur Jev API
Zugang zur Jev-API auf der offiziellen Website
Typisierte Entscheidungen, kalibrierte Konfidenz, ein einziger API-Aufruf.