API

Appelez des jugements depuis votre programme avec une clé API. L'inscription offre $$5.00 de crédit. Comme jev-1.13.0 : uniquement les tokens d'entrée, $$0.042 par million, sortie gratuite.

Émettez une clé sur votre page de compte. Le texte en clair n'est affiché qu'une fois ; le serveur ne conserve que son sha256.

Obtenir une clé sur votre compte

Authentification

Chaque requête /v1/* exige une clé Bearer. Clés uniquement — les cookies de session ne sont pas acceptés, pour séparer la connexion web et les appels facturés.

Authorization: Bearer jev_...

Points de terminaison

`POST /v1/judge`	Lancez un jugement. Facturé sur les tokens d'entrée de cet appel, et seulement après succès. Les échecs en amont ne sont pas facturés.
`GET /v1/me`	Utilisateur actuel, solde et dépenses totales.
`GET /v1/usage`	Solde, dépenses totales et dernières écritures.

Corps de la requête (/v1/judge)

`state`	Le texte à juger, 8 à 4000 caractères.
`questions`	Jusqu'à 6 questions ; les clés doivent être des identifiants commençant par une minuscule.

Types de question

`noul`	Pertinence, renvoie un nombre décimal de 0 à 1.
`confidence`	Confiance, renvoie un nombre décimal de 0 à 1.
`choice`	Choisissez une option et renvoyez la chaîne retenue. Envoyez un tableau options ou un objet criteria ; les options sont repliées dans criteria avant le modèle.

Réponse

Solde après cet appel.

{
  "id": "k3f9a1c2b4d5",
  "model": "clavue-jev",
  "answers": {
    "relevance":  { "noul": 0.92 },
    "confidence": { "noul": 0.78 },
    "severity":   { "choice": "medium" }
  },
  "credit": { "cents": 500, "usd": "5.00", "microUsd": 5000000, "inputTokensLeft": 119047619 }
}

L'objet credit

{
  "cents": 500,
  "usd": "5.00",
  "microUsd": 5000000,
  "inputTokensLeft": 119047619
}

`cents`	Solde restant arrondi au centime. usd et microUsd sont exacts.
`usd`	Chaîne USD. Les petits montants conservent les chiffres en microdollars.
`microUsd`	Microdollars restants. 1 USD = 1 000 000.
`inputTokensLeft`	Tokens d'entrée que ce solde couvre encore à 0,042 $ par million.

Erreurs

Statut	error
`401`	`unauthorized / invalid_api_key`	Clé API manquante ou invalide.
`400`	`invalid_request`	state trop court, ou aucune question.
`429`	`quota_exceeded`	Solde insuffisant ; inclut retry-after.
`502`	`upstream_unavailable`	Le backend de jugement est indisponible. Non facturé.

Exemple

curl https://api.jevcode.ai/v1/judge \
  -H "Authorization: Bearer jev_..." \
  -H "Content-Type: application/json" \
  -d '{
    "state": "The build failed on the second job, then passed after a retry.",
    "questions": {
      "relevance":   { "type": "noul",       "instructions": "Is this about CI?" },
      "confidence":  { "type": "confidence", "instructions": "How sure are you?" },
      "severity":    { "type": "choice",     "instructions": "Pick one.",
                       "options": ["low", "medium", "high"] }
    }
  }'

En essayer une sur la page d'essai Tarifs

Continuer sur ce site

Essai, documentation, cas et tarifs renvoient l'un à l'autre. La page suivante est sur ce site.

API