¿Qué es Jev? Guía de la API System One de TypeSafe
Jev es el modelo System One de TypeSafe AI. No es un chatbot ni un generador de código: la aplicación envía state y preguntas tipadas, y Jev devuelve decisiones Choice, Score o Noul con probabilidad y confianza.
TypeSafe presentó Jev en acceso temprano el 15 de septiembre de 2026. Comprueba acceso y precios en la documentación oficial; la disponibilidad y facturación del gateway aparecen en la página de precios.
Decisiones nativas de Jev: la URL no es la del chat
jev-latest usa el protocolo nativo de decisiones, no un cliente de chat normal. La pasarela y la API directa de TypeSafe tienen URL y claves distintas.
| Conexión | URL POST completa | Clave API |
|---|---|---|
| Pasarela recomendada | https://api.llm-token.cn/v1/decisions |
Clave LLM API Gateway |
| Entrada compatible | https://api.llm-token.cn/v1/systemone |
Clave LLM API Gateway |
| TypeSafe directo | https://api.typesafe.ai/v1/systemone |
Clave TypeSafe |
Si la Base URL ya es https://api.llm-token.cn/v1, añade solo /decisions o /systemone, no /v1/v1/decisions.
Envía model, state y questions. questions es un objeto con IDs de pregunta como claves; cada pregunta contiene type e instructions. Los criteria de choice son un objeto de opciones; los de score, un array ordenado; noul evalúa la probabilidad de sí/no. No envíes messages de chat ni actives streaming.
Petición mínima
Guarda la clave de la pasarela en la variable de entorno LLM_API_KEY. El ejemplo hace una llamada real; confirma tu saldo y la facturación antes de ejecutarlo. Lee answers.is_urgent.noul y usage, no choices[0].message.content.
curl -sS -X POST https://api.llm-token.cn/v1/decisions \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<'JSON'
{
"model": "jev-latest",
"state": "The order is due today and the payment has failed.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this require urgent attention?"
}
}
}
JSON
Si 500 / convert_request_failed contiene this channel only supports native decisions requests, comprueba si el cliente sigue llamando a /v1/chat/completions o /v1/messages. Es un problema de protocolo, no de saldo. Recargar o cambiar a pago por uso no cambia el protocolo. Corrige la URL y el cuerpo antes de reintentar; no repitas la petición de chat original.
Formato y solución de errores · Skill de integración de Jev · Referencia API de TypeSafe
IDs y API
Los IDs son jev-latest, jev-preview y la versión fija jev-1.13.0. Los alias pueden cambiar: en producción registra el campo model o fija una versión. El endpoint oficial es POST https://api.typesafe.ai/v1/systemone con state, model y questions.
Choice selecciona una categoría, Score puntúa una escala y Noul responde una pregunta sí/no. Jev funciona para enrutar tickets, puertas de riesgo, selección de herramientas y filtros de búsqueda. Los permisos y la acción final siguen siendo responsabilidad del código de la aplicación.
La documentación indica contexto 64K, cobro de tokens de entrada y salida gratuita, pero precios y límites pueden cambiar. Jev no acepta directamente imágenes, audio ni vídeo. Consulta la documentación API y los precios.
FAQ
¿Jev es un LLM generativo?
No. Es un nodo de decisión estructurada; usa un modelo generativo para escribir, traducir o programar.
¿Qué ID debo usar?
jev-latest para evaluar y jev-1.13.0 para producción reproducible, después de pruebas de regresión.
¿La probabilidad garantiza que sea correcto?
No. Mantén revisión humana y mide calibración, errores y deriva.
Fuentes: TypeSafe models, Quick Start, Jev launch.