Qué es Jev y cuándo usar su API
Jev es un modelo de decisiones de TypeSafe. Recibe contexto para una pregunta delimitada y devuelve una respuesta tipada. Una primera tarea útil es asignar un ticket a facturación, soporte técnico o acceso. Tu aplicación decide qué hacer después.
TypeSafe lo denomina modelo System One. Un modelo de chat puede redactar explicaciones o planificar tareas; esta API sirve para obtener categorías, puntuaciones o juicios de tipo sí/no. No navega ni ejecuta herramientas. Compara resultados con tus propios ejemplos, sin asumir ventajas universales de coste, velocidad o precisión.
Prueba una decisión antes de crear la clave
Abre el área de pruebas, elige soporte, contactos o comentarios, y cambia el mensaje y las etiquetas. Ver el ejemplo ilustrativo no llama al modelo. Ejecutar una decisión real es una acción distinta, sujeta a los límites de prueba y la disponibilidad.
Usa ejemplos anonimizados y suficiente contexto para distinguir las etiquetas. Reserva otros ejemplos para evaluar: una respuesta convincente no demuestra la precisión del sistema.
Obtén tu clave de Jev API
Accede a este espacio, elige un plan con acceso API activo y crea una clave con nombre en tu panel. Copia el secreto cuando se muestre y guárdalo en el servidor. Una clave de TypeSafe, OpenRouter u otra comunidad no es una clave de Jev API Pro.
Envíala en Authorization: Bearer. Una cookie de inicio de sesión no autoriza REST. Nunca pongas secretos en JavaScript del navegador, repositorios públicos, prompts o archivos Skill. Revoca las claves expuestas o que ya no uses.
Envía la solicitud y lee la respuesta
El ejemplo curl anterior llama a POST https://jevapi.pro/api/v1/decisions. Sustituye YOUR_API_KEY por tu clave de servidor. Envía text, instructions, labels distintos y threshold. Usa una Idempotency-Key nueva para cada decisión distinta; reutilízala solo para la misma solicitud sin cambios.
Una decisión nueva devuelve HTTP 201. choice contiene la etiqueta y needsReview indica revisión. confidence puede ser null si el proveedor no la devuelve: no lo conviertas en certeza. Conserva id para soporte. La referencia completa describe límites, preguntas múltiples y campos de respuesta.
Conecta un agente mediante REST
Mantén el modelo principal y los permisos de herramientas de tu agente. Cuando deba elegir una ruta, llama desde tu servidor al mismo endpoint con la tarea, instrucciones explícitas y resultados permitidos como continuar o revisar. Valida la elección antes del siguiente paso.
Si needsReview es true, falta confianza o falla la solicitud, utiliza revisión. Una predicción no autoriza reembolsos, mensajes ni eliminaciones. Aplica esas reglas en tu aplicación. Aquí se documenta REST; una URL MCP o herramienta jev_* de otro sitio no pertenece a este servicio.
{
"text": "Task: read a public API guide and summarize its supported request fields. No account changes or external messages are requested.",
"instructions": "Choose review if the task is unclear or could change external state. Otherwise choose proceed. This classification never grants permission to execute a tool.",
"labels": [
"proceed",
"review"
],
"threshold": 0.9
}Recupera errores sin duplicar trabajo
Corrige entradas en un 400, revisa clave y acceso en 401/403, y créditos en 402. Ante 429 respeta Retry-After si aparece y limita los reintentos. Una caída del proveedor debe activar una alternativa visible.
La misma clave y el mismo cuerpo recuperan una decisión completada sin cobrarla de nuevo. Cambiar el cuerpo produce 409. Repetir una solicitud registrada como fallida también devuelve 409: resuelve la causa y usa otra clave para un nuevo intento deliberado. Si un timeout deja el resultado desconocido, consulta primero con la misma clave.
Precios de Jev API y siguiente paso
Jev API Pro ofrece periodos prepagados con créditos de decisión, no la tarifa directa por tokens del proveedor. Consulta precios, créditos, duración y condiciones actuales en la página de planes. Una compra aquí no añade saldo a TypeSafe ni OpenRouter.
Prueba tu tarea antes de pagar. Antes de producción, comprueba entradas ambiguas, confianza ausente, claves vencidas y fallos del proveedor. Empieza con sugerencias revisables y automatiza solo lo que respalde tu evaluación.