API de décision

Envoyez un contexte et une question. Recevez une décision structurée.

Créez une clé API dans les paramètres de votre compte et achetez des crédits. Envoyez Authorization: Bearer YOUR_API_KEY et un Idempotency-Key unique pour chaque décision. L’utilisation est facturée au propriétaire de la clé ; ne l’exposez jamais dans le navigateur.

Un exemple d’API Jev pour votre prochaine intégration

Appelez l’API REST iajev avec cURL. Recevez un choix, des probabilités et un niveau de confiance en JSON.

Lire la documentation de l’API iajev

Requête

curl https://iajev.com/api/v1/decisions/run \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -H 'Content-Type: application/json' \
  --data '{
  "state": {
    "message": "Mon abonnement a été facturé deux fois le mois dernier et je n’ai toujours pas reçu de remboursement.",
    "plan": "pro",
    "country": "FR"
  },
  "decision": {
    "type": "choice",
    "question": "Quelle équipe doit traiter cette demande ?",
    "choices": [
      "Facturation",
      "Technique",
      "Ventes",
      "Fraude"
    ]
  }
}'

Champs de la requête

state.message: Texte obligatoire ; de 1 à 8 000 caractères.
state.<field>: Jusqu’à 5 champs facultatifs en plus de message. Noms : 1 à 40 caractères. Valeurs : texte de 300 caractères maximum, nombre fini ou booléen. Les objets imbriqués ne sont pas pris en charge.
decision.type: Utilisez "choice". Cette API ne prend pas encore en charge les scores ou les requêtes booléennes.
decision.question: Texte obligatoire ; de 1 à 300 caractères.
decision.choices: 2 à 8 chaînes distinctes non vides ; 80 caractères maximum chacune.

Champs de la réponse

decision: Le choix sélectionné.
confidence: Une estimation distincte du niveau de confiance entre 0 et 1.
results: Chaque choix et sa probabilité, par ordre décroissant.
meta: Latence en millisecondes et identifiant de requête pour le diagnostic.
billing: Crédits facturés, inputTokens et outputTokens pour cette requête.

Erreurs et limites

400: Données invalides ou Idempotency-Key manquant.
401: Clé API absente, invalide, expirée ou révoquée.
402: Crédits disponibles insuffisants.
409: Requête en cours, déjà échouée ou clé d’idempotence réutilisée avec d’autres données.
403: Compte non vérifié ou désactivé.
413: La requête dépasse 16 000 octets UTF-8, tous champs compris.
415: Content-Type doit être application/json.
429: Limite de la clé API atteinte. Respectez l’en-tête Retry-After.
502 / 503 / 504: Décision indisponible ou délai dépassé. Évitez les tentatives répétées immédiates.

Structure de réponse

{
  "decision": "Billing",
  "confidence": 0.8,
  "results": [
    { "value": "Billing", "probability": 0.87 },
    { "value": "Technical", "probability": 0.10 },
    { "value": "Sales", "probability": 0.02 },
    { "value": "Fraud", "probability": 0.01 }
  ],
  "meta": { "latencyMs": 218, "requestId": "…" },
  "billing": { "credits": 1, "inputTokens": 380, "outputTokens": 0 }
}

Consulter vos crédits disponibles

curl https://iajev.com/api/v1/credits -H 'Authorization: Bearer YOUR_API_KEY'

Chaque requête payante réserve temporairement 32 crédits, puis facture 1 crédit par tranche entamée de 1 000 tokens d’entrée (minimum 1). Les crédits inutilisés sont libérés ; les échecs ne sont pas facturés. Après une erreur de connexion, conservez le même Idempotency-Key. HTTP 409 REQUEST_PENDING signifie qu’il faut attendre puis réessayer avec la même clé ; REQUEST_FAILED nécessite une nouvelle clé. Réutiliser une clé avec d’autres données renvoie 409.

N’incluez aucun secret ni donnée personnelle superflue. Le contexte est transmis pour l’inférence. Les requêtes authentifiées et API conservent données, résultats et facturation dans votre historique privé. Les décisions enregistrées gardent aussi leur contexte. L’aperçu anonyme ne stocke que les compteurs de limitation, sans historique de décisions.