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 cuentaAutenticació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/judge | Ejecuta 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/me | Usuario actual, saldo y gasto total. |
GET /v1/usage | Saldo, gasto total y movimientos recientes. |
Cuerpo de la solicitud (/v1/judge)
state | El texto a juzgar, 8–4000 caracteres. |
questions | Hasta 6 preguntas; las claves deben ser identificadores que empiecen con minúscula. |
Tipos de pregunta
noul | Relevancia, devuelve un decimal de 0 a 1. |
confidence | Confianza, devuelve un decimal de 0 a 1. |
choice | Elige 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
}cents | Saldo restante redondeado al centavo. usd y microUsd son exactos. |
usd | Cadena USD. Los importes pequeños conservan dígitos en microdólares. |
microUsd | Microdólares restantes. 1 USD = 1.000.000. |
inputTokensLeft | Tokens de entrada que este saldo aún cubre a $0.042 por millón. |
Errores
| Estado | error | |
|---|---|---|
401 | unauthorized / invalid_api_key | Clave de API ausente o inválida. |
400 | invalid_request | state demasiado corto, o sin preguntas. |
429 | quota_exceeded | Saldo insuficiente; incluye retry-after. |
502 | upstream_unavailable | El 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
- Probar un juicioEscribe un estado y lee la respuesta.
- Escenas en vivoTetris, seis juicios rápidos y una clasificación. Copia la llamada y ejecútala de nuevo.
- LaboratorioClasificación de soporte, revisión de releases y más: edita y ejecuta al instante.
- Compararclavue-jev y jev-1.13.0 responden a la misma pregunta.
- DemosEjemplos de juicio que puedes editar.
- PreciosLa entrada cuesta $0.042 por millón de tokens. La salida es gratis.
Documentación
- IntroducciónPara qué sirve este modelo.
- Inicio rápidoLa llamada mínima que funciona.
- System OneEscrito aquí: un estado más una pregunta tipada. El modelo es clavue-jev.
- EstadoEl texto que envías.
- ConfianzaCuán segura es la respuesta, y cuándo actuar.
- ChoiceElegir una opción mutuamente excluyente.
- NoulUna pregunta de sí/no, devuelta como probabilidad de sí.
- ScorePuntuar en una escala.
- Enrutamiento de intenciónUna llamada Choice despacha la solicitud.
- Enrutamiento por confianzaActuar si la confianza es alta; derivar si es baja.
- Fan-outHacer varias preguntas a un estado.
- Puntuación compuestaCombinar varias puntuaciones en un ranking.
- HTTP APILa forma de la solicitud sin SDK.
- SDK de PythonLlamar a un juicio desde Python.
- SDK de JavaScriptLlamar a un juicio desde JavaScript.
Casos
- Mapa de casos de usoQué primitiva se usa para cada tarea.
- Barreras de seguridadUna comprobación sí/no antes de una acción.
- Llamada a funciónDecidir con un juicio qué función llamar.
- Clasificar con confianzaNo actuar si la clase es dudosa.
- Búsqueda semánticaEncontrar los pasajes que coinciden.
- Preguntas paralelasPreguntar todo el conjunto en una llamada.
- Clasificación jerárquicaPrimero la clase gruesa, luego la fina.
- Verificación de citasSi una frase está respaldada por la fuente.
- Alineación de entidadesSi dos nombres son lo mismo.
- Sugerencia de habilidadElegir la habilidad que encaja ahora.
Más en este sitio
- Directorio del sitioLa lista completa de las páginas anteriores.
- EcosistemaProyectos de la comunidad por categoría.
- Cobertura JevCada entrada indica la decisión y su evidencia.
- Casos diariosEl siguiente lote del banco, cada día.
- ComunidadPublicaciones públicas, cada una con su fuente.
- BuildsNotas sobre las actualizaciones del modelo y del sitio.
- PrimitivasChoice, Noul y Score juntos.
- PatronesEnrutamiento, fan-out y puntuación compuesta.
- SDKHTTP, Python y JavaScript.