Pruébalo aquí y crea tu key
Prueba una decisión acotada en el Playground de jevmodel.org. Cuando el resultado sea útil, inicia sesión, abre el panel, crea una API key y guárdala como JEVMODEL_API_KEY en tu servidor.
Mantén el conjunto de respuestas pequeño y estable. Nombra el campo según la rama que tomará tu código, no según un tema vago.
import os
import requests
response = requests.post(
"https://jevmodel.org/v1/systemone",
headers={"Authorization": f"Bearer {os.environ['JEVMODEL_API_KEY']}"},
json={
"state": "I was charged twice. Please fix this ASAP.",
"model": "jev-latest",
"questions": {
"category": {
"type": "choice",
"instructions": "What is this ticket about?",
"criteria": {"billing": "payments", "technical": "broken product", "other": "other"},
},
},
},
timeout=15,
)
print(response.json()) El contrato HTTP
Repos que ya envían esta petición aparecen en el directorio de proyectos de Jev.
Envía un POST a https://jevmodel.org/v1/systemone. model selecciona jev-latest o una versión fija. state admite hasta 8.000 caracteres después de serializarse. questions contiene entre 1 y 8 preguntas choice, score o noul con nombre.
- El endpoint de jevmodel.org permite 120 peticiones por minuto para cada API key.
- Cada petición correcta cobra tokens de entrada. Los fallos del proveedor se reembolsan; añade Idempotency-Key al reintentar.
- Pon un umbral de confianza en tu código. Jev facilita la rama, pero no elimina el riesgo.
curl -X POST https://jevmodel.org/v1/systemone \
-H "Authorization: Bearer $JEVMODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev-latest",
"state": "Customer: I was charged twice and I am furious.",
"questions": {
"topic": {
"type": "choice",
"instructions": "What is the issue about?",
"criteria": { "billing": "money problems", "bug": "broken product" }
},
"urgent": {
"type": "noul",
"instructions": "Escalate to a human now?"
}
}
}' Qué hacer con la respuesta
Ramifica en el código de tu aplicación. Si topic es billing y escalate.noul supera tu umbral, pásalo a una persona. Si la confianza es baja, envía el mismo estado a un modelo mayor o a un revisor. Registra entrada, salida, versión y el resultado posterior para saber si Jev realmente ayuda al flujo o solo parece decidido.
Preguntas frecuentes
¿Cómo uso la API de Jev?
Crea una key en el panel de jevmodel.org, guárdala como JEVMODEL_API_KEY y envía JSON a https://jevmodel.org/v1/systemone con autenticación Bearer.
¿Qué ID de modelo de Jev debo fijar?
Usa jev-1.13.0 en producción una vez ajustados tus umbrales. jev-latest y jev-preview apuntan hoy a la misma versión, pero los alias pueden cambiar.
¿Puedo probar Jev antes de programar?
Sí. Usa primero el Playground de jevmodel.org. Emplea los mismos tipos de pregunta que la API; después puedes crear una key en el panel.
¿Jev entiende español?
Según la documentación de TypeSafe, el inglés es el idioma principal de entrenamiento y donde mejor precisión logra; otros idiomas funcionan, pero no igual de bien. Prueba tus casos en español con datos reales antes de ponerlos en producción y vigila la confianza.