L’API Jev accepte un state et des questions typées nommées ; elle renvoie les réponses sous ces mêmes noms. Nous commençons par une vérification d’urgence. Le format suit la documentation officielle, mais n’a pas été testé en direct avec une clé API appartenant à ce site.

1. Obtenir un accès et protéger la clé

Essayez le Playground officiel ou connectez-vous à la console pour obtenir une clé. Vérifiez votre accès au modèle et la facturation. Stockez TYPESAFE_API_KEY dans l’environnement du terminal ou un gestionnaire de secrets côté serveur, jamais dans une page publique, un dépôt ou du code navigateur.

Accès officiels: Playground · API keys

2. Envoyer une petite requête

L’exemple cURL lit une variable d’environnement et fixe jev-1.13.0 pour identifier la version. Le state et la question restent en anglais dans les traductions ; les autres langues doivent être évaluées séparément. Exécuter cette commande avec votre clé envoie une requête réelle, potentiellement facturée.

curl --fail-with-body --max-time 30 \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "model": "jev-1.13.0",
  "state": "Our payment integration has failed for three days. Please help ASAP.",
  "questions": {
    "urgency": {
      "type": "noul",
      "instructions": "Does this message express urgency?"
    }
  }
}
JSON

3. Lire la réponse

Repérez answers.urgency.noul. Noul est la probabilité que la réponse soit oui, pas une étiquette textuelle. model indique la version utilisée et usage.input_tokens sert à mesurer le coût. Le fragment ci-dessous est illustratif, sans capture d’un appel réel ; votre valeur peut différer.

Fragment de réponse illustratif:

{
  "model": "jev-1.13.0",
  "answers": {
    "urgency": {
      "type": "noul",
      "noul": 0.94
    }
  }
}

4. Définir l’action du programme

Validez le type et la plage numérique. Une règle illustrative peut placer les valeurs d’au moins 0,8 dans une file urgente et traiter les autres normalement ou manuellement. Ce seuil n’est pas une valeur sûre officielle : choisissez-le avec des exemples étiquetés et le coût des erreurs. Le résultat ne doit jamais contourner les permissions.

5. Ajouter Choice ou Score

Pour l’équipe, utilisez Choice avec des criteria explicites pour facturation, technique, commercial et une solution de repli. Pour une évaluation ordonnée, décrivez les niveaux de Score. Les deux renvoient confidence et des probabilités. Noul renvoie une probabilité de oui ; ne supposez pas qu’il expose le même champ confidence.

6. Gérer erreurs et changements

En cas d’échec d’authentification, vérifiez en-tête, clé et accès ; pour une requête invalide, vérifiez JSON et schéma. Avec 429, respectez retry-after si présent et limitez les reprises avec attente progressive. Les SDK officiels gèrent déjà des reprises. Prévoyez des délais, des actions idempotentes et une vérification des réponses manquantes. Réévaluez les seuils avant de changer de modèle.

Pour continuer

Vue d’ensemble · Cas d’usage · Tarifs · Limites

Sources et lectures complémentaires