Testez ici, puis créez votre clé
Ouvrez le Playground de jevmodel.org et testez une décision étroite. Quand la sortie est utile, connectez-vous, ouvrez le Dashboard, créez une clé API et enregistrez-la sous JEVMODEL_API_KEY sur votre serveur.
Gardez l’ensemble de réponses petit et stable. Nommez le champ d’après la branche que votre code prendra, pas d’après un thème vague.
import os
import requests
response = requests.post(
"https://jevmodel.org/v1/systemone",
headers={"Authorization": f"Bearer {os.environ['JEVMODEL_API_KEY']}"},
json={
"state": "I was charged twice. Please fix this ASAP.",
"model": "jev-latest",
"questions": {
"category": {
"type": "choice",
"instructions": "What is this ticket about?",
"criteria": {"billing": "payments", "technical": "broken product", "other": "other"},
},
},
},
timeout=15,
)
print(response.json()) Le contrat HTTP
Les dépôts qui envoient déjà cette requête sont listés dans l’annuaire des projets Jev.
Envoyez un seul POST à https://jevmodel.org/v1/systemone. model sélectionne jev-latest ou une version fixée. state peut être une chaîne ou une valeur JSON jusqu’à 8 000 caractères après sérialisation. questions est un objet de 1 à 8 questions nommées de type choice, score ou noul.
- L’endpoint jevmodel.org autorise 120 requêtes par minute pour chaque clé API.
- Chaque requête réussie consomme des tokens d’entrée. Les requêtes en échec amont sont remboursées ; ajoutez un en-tête Idempotency-Key lors des réessais.
- Mettez un seuil de confiance dans votre code. Jev facilite la branche, il ne la rend pas sans risque.
curl -X POST https://jevmodel.org/v1/systemone \
-H "Authorization: Bearer $JEVMODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev-latest",
"state": "Customer: I was charged twice and I am furious.",
"questions": {
"topic": {
"type": "choice",
"instructions": "What is the issue about?",
"criteria": { "billing": "money problems", "bug": "broken product" }
},
"urgent": {
"type": "noul",
"instructions": "Escalate to a human now?"
}
}
}' Que faire de la réponse
Branchez dans le code applicatif. Si topic vaut billing et que escalate.noul dépasse votre seuil, routez vers un humain. Si la confiance est faible, envoyez le même état à un modèle plus grand ou à un relecteur. Journalisez l’entrée, la sortie, la version et le résultat aval pour savoir si Jev aide réellement le workflow ou fait seulement semblant d’être décisif.
FAQ
Comment utiliser l’API Jev ?
Créez une clé dans votre Dashboard jevmodel.org, enregistrez-la sous JEVMODEL_API_KEY, puis POSTez du JSON vers https://jevmodel.org/v1/systemone avec une authentification Bearer.
Quel ID de modèle Jev faut-il fixer ?
Utilisez jev-1.13.0 en production si vos seuils sont réglés. jev-latest et jev-preview pointent actuellement vers la même version, mais les alias peuvent bouger.
Puis-je tester Jev avant d’écrire du code ?
Oui. Utilisez d’abord le Playground de jevmodel.org. Il emploie les mêmes types de questions que l’API : vous pouvez valider la forme avant de créer une clé.
Jev comprend-il le français ?
Selon la documentation TypeSafe, l’anglais est la principale langue d’entraînement et offre la meilleure précision ; les autres langues sont traitées, mais un peu moins bien. Testez vos charges en français avec des données réelles avant la mise en production et surveillez la confiance.