API

API

Llama a juicios desde tu propio programa con una clave de API. El registro incluye $$5.00 de crédito. Igual que jev-1.13.0: solo tokens de entrada, $$0.042 por millón, salida gratis.

Emite una clave en tu página de cuenta. El texto claro se muestra una vez; el servidor solo conserva su sha256.

Obtener una clave en tu cuenta

Autenticación

Toda solicitud /v1/* necesita una clave Bearer. Solo claves: no se aceptan cookies de sesión, así el inicio de sesión web y las llamadas facturadas quedan separados.

Authorization: Bearer jev_...

Endpoints

POST /v1/judgeEjecuta un juicio. Se factura por los tokens de entrada de esta llamada, y solo tras el éxito. Los fallos en origen no se cobran.
GET /v1/meUsuario actual, saldo y gasto total.
GET /v1/usageSaldo, gasto total y movimientos recientes.

Cuerpo de la solicitud (/v1/judge)

stateEl texto a juzgar, 8–4000 caracteres.
questionsHasta 6 preguntas; las claves deben ser identificadores que empiecen con minúscula.

Tipos de pregunta

noulRelevancia, devuelve un decimal de 0 a 1.
confidenceConfianza, devuelve un decimal de 0 a 1.
choiceElige una opción y devuelve la cadena elegida. Envía un array options o un objeto criteria; las options se integran en criteria antes del modelo.

Respuesta

Saldo tras esta llamada.

{
  "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 }
}

El objeto credit

{
  "cents": 500,
  "usd": "5.00",
  "microUsd": 5000000,
  "inputTokensLeft": 119047619
}
centsSaldo restante redondeado al centavo. usd y microUsd son exactos.
usdCadena USD. Los importes pequeños conservan dígitos en microdólares.
microUsdMicrodólares restantes. 1 USD = 1.000.000.
inputTokensLeftTokens de entrada que este saldo aún cubre a $0.042 por millón.

Errores

Estadoerror
401unauthorized / invalid_api_keyClave de API ausente o inválida.
400invalid_requeststate demasiado corto, o sin preguntas.
429quota_exceededSaldo insuficiente; incluye retry-after.
502upstream_unavailableEl backend de juicio está caído. Sin cargo.

Ejemplo

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"] }
    }
  }'

Sigue en este sitio

Prueba, documentación, casos y precios se enlazan entre sí. La página siguiente está en este sitio.

Usar clavue-jev

Documentación

Casos

Más en este sitio