API Jev : accès, requêtes et SDK
L'API Jev tient en un endpoint : vous envoyez un état et des questions typées, vous lisez des réponses typées avec leurs probabilités. Voici le format, un constructeur de requêtes et les SDK officiels.
L'API Jev en bref : un endpoint, un état, des questions
Tout passe par une requête HTTP POST authentifiée par une clé API (en-tête Authorization: Bearer). Le corps contient le modèle (jev-latest), l'état que Jev doit lire et un dictionnaire de questions. La réponse contient une réponse typée par question et l'usage en tokens.
POST https://api.typesafe.ai/v1/systemone
Authorization: Bearer <API_KEY>
Content-Type: application/json
{ "model": "jev-latest", "state": "...", "questions": { ... } }La clé se crée dans la console TypeSafe. Le format d'une requête et de sa réponse est décrit dans le quickstart officiel et dans la référence de l'API.
Les trois types de questions Jev : Noul, Choice et Score
Chaque question a un type, qui fixe la forme de la réponse. Vous pouvez en poser plusieurs sur le même état dans une seule requête : elles sont évaluées en parallèle et ajouter des questions ne coûte que les tokens d'entrée supplémentaires.
requête
{
"type": "noul",
"instructions": "The message conveys\n urgency or time-sensitivity"
}réponse
{
"type": "noul",
"noul": 1.0
}Un Noul répond à une question oui/non par la probabilité que l'affirmation soit vraie. Utile pour des indicateurs comme urgent, spam, hors-sujet ou tentative de jailbreak.
requête
{
"type": "choice",
"instructions": "Which team should\n handle this",
"criteria": {
"billing": "Payment issues",
"technical": "Bugs, integrations",
"sales": "Pricing questions"
}
}réponse
{
"type": "choice",
"choice": "technical",
"confidence": 0.78,
"probabilities": {
"technical": 0.85,
"sales": 0.0,
"billing": 0.15
}
}Un Choice sélectionne une option parmi celles que vous définissez et renvoie une probabilité pour chacune, plus une confiance globale. Jev accepte jusqu'à 255 options par question.
requête
{
"type": "score",
"instructions": "How frustrated the\n customer appears",
"criteria": [
"Calm, just stating facts",
"Frustrated but civil",
"Very angry, strong language"
]
}réponse
{
"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 }
}Un Score note l'état selon des niveaux ordonnés que vous décrivez. Vous obtenez un score continu, la distribution sur les niveaux et une valeur de confiance, pratique pour un scoring composite dans votre code.
Constructeur de requêtes Jev : JSON, cURL et Python
Composez une requête Jev et copiez-la en JSON, cURL ou Python. Rien n'est envoyé : ce site n'appelle jamais l'API Jev. Pour l'exécuter, utilisez une clé API de la console TypeSafe.
SDK Jev : Python, JavaScript et LangChain
# Python 3.10+ pip install typesafe-sdk from typesafe_sdk import Noul, TypeSafeClient client = TypeSafeClient() # lit TYPESAFE_API_KEY res = client.system_one( state="Le paiement échoue pour tous les clients depuis 9h.", questions={"urgent": Noul(instructions="Needs attention right now")}, ) print(res.answers["urgent"].noul)
pip install langchain-typesafe # définissez TYPESAFE_API_KEY, puis : 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 # Autres agents de code npx skills add typesafe-ai/skills --skill typesafe-ai
choice(), score() et noul() typées. Les instructions d'installation et la référence complète sont dans la documentation du SDK JavaScript, et le code source est sur GitHub.Il existe aussi system-one-adapter-python, un client compatible qui exécute les mêmes requêtes System One sur des API de LLM, pratique pour comparer Jev à un modèle généraliste.
Comment obtenir une clé API Jev
- Rejoignez l'accès anticipé sur typesafe.ai. Jev est en accès anticipé : TypeSafe fait entrer les développeurs de sa liste d'attente.
- Ouvrez la console TypeSafe et créez une clé dans la page des clés API.
- Envoyez votre première requête depuis le playground ou avec cURL, Python ou LangChain.
Bonnes pratiques d'intégration de Jev : quatre patterns
TypeSafe recommande de garder le code aux commandes et de ne confier à Jev que des décisions étroites et structurées. Quatre patterns reviennent dans sa documentation.
Fan-out spéculatif
Envoyez plusieurs questions dans un seul appel, y compris des questions spéculatives, et laissez votre code décider de ce qui est pertinent. Le cookbook « questions parallèles » de TypeSafe mesure un appel groupé de 13 questions 12,2 fois moins cher et 10 fois plus rapide que des appels séparés, sans changement de réponses.
Routage par confiance
Utilisez la confiance comme second axe : la réponse dit quoi, la confiance dit s'il faut agir. Les cas incertains partent vers un humain ou un modèle plus puissant.
Scoring composite
Découpez un jugement complexe en scores atomiques, puis combinez-les avec des pondérations que vous contrôlez dans le code.
Routage d'intentions
Classez les demandes entrantes et envoyez chacune vers le meilleur gestionnaire : logique déterministe, LLM spécialisé ou humain.
Pour aller plus loin sur l'API Jev
Obtenir l'accès à l'API Jev sur le site officiel
Décisions typées, confiance calibrée, un seul appel d'API.