La API de Jev recibe un state y preguntas tipadas con nombre, y devuelve respuestas bajo esos mismos nombres. Usaremos una comprobación de urgencia pequeña. La solicitud sigue el formato oficial; no se ha probado en directo con una clave API propia de este sitio.

1. Obtén acceso y protege la clave

Prueba el Playground oficial o entra en la consola para obtener una clave. Confirma el acceso al modelo y las condiciones de facturación. Guarda TYPESAFE_API_KEY como variable de entorno o secreto del servidor, nunca en una página pública, un repositorio o el código del navegador.

Accesos oficiales: Playground · API keys

2. Envía una solicitud pequeña

El ejemplo cURL lee la variable de entorno y fija jev-1.13.0 para identificar la versión. El state y la pregunta permanecen en inglés en todas las traducciones; otros idiomas requieren evaluación aparte. Ejecutarlo con tu clave envía una solicitud real que puede generar costes.

curl --fail-with-body --max-time 30 \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "model": "jev-1.13.0",
  "state": "Our payment integration has failed for three days. Please help ASAP.",
  "questions": {
    "urgency": {
      "type": "noul",
      "instructions": "Does this message express urgency?"
    }
  }
}
JSON

3. Lee la respuesta

Busca answers.urgency.noul. Noul es la probabilidad de una respuesta afirmativa, no una etiqueta textual. model indica la versión y usage.input_tokens ayuda a medir costes. El fragmento siguiente es ilustrativo, no una respuesta capturada de la API; tu valor puede ser distinto.

Fragmento de respuesta ilustrativo:

{
  "model": "jev-1.13.0",
  "answers": {
    "urgency": {
      "type": "noul",
      "noul": 0.94
    }
  }
}

4. Decide la siguiente acción

Valida el tipo y el rango numérico. Una regla ilustrativa podría enviar valores de al menos 0,8 a la cola urgente y los demás a tratamiento normal o revisión. No es un umbral oficial seguro: elígelo según datos etiquetados y los costes de los falsos positivos y negativos. No permitas que el modelo evite controles de acceso.

5. Añade Choice o Score

Para dirigir tickets, usa Choice con criteria claros para facturación, soporte, ventas y una opción de reserva. Para una evaluación ordenada, define cada nivel de Score. Ambos devuelven probabilidades y confidence. Noul devuelve una probabilidad afirmativa; no presupongas el mismo campo confidence.

6. Gestiona errores y cambios

Ante fallos de autenticación, revisa cabecera, clave y permisos; ante solicitudes inválidas, JSON y esquema. Con 429, respeta retry-after si existe y usa espera progresiva con reintentos limitados. Los SDK oficiales incluyen reintentos. Configura tiempos máximos, acciones idempotentes y revisión para respuestas inválidas. Reevalúa umbrales antes de cambiar el modelo fijado.

Sigue leyendo

Resumen · Casos de uso · Precios · Limitaciones

Fuentes y otras lecturas