Documentación

Todo lo que necesitas para pasar del Playground a producción.

Inicio rápido

Crea una cuenta, genera una clave de API en el panel y envía tu primera solicitud. Las claves se muestran una sola vez: guárdalas como secreto en el servidor, nunca en código del navegador.

curl

curl https://jevai.website/api/v1/systemone \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "state": "The deployment failed three times and production is returning 500s.",
  "questions": {
    "needs_human": {
      "type": "noul",
      "instructions": "Should this be escalated to a person?"
    }
  }
}'

Solicitud

Envía un cuerpo JSON con un `state` y un mapa de `questions` con nombre. El campo opcional `model` se acepta por compatibilidad y se ignora. `state` puede ser una cadena, un array de cadenas o un objeto JSON, de hasta 100,000 caracteres.

Respuesta

Las respuestas se indexan por el nombre de tus preguntas. Cada respuesta incluye un `request_id` que puedes indicar al soporte.

Tipos de pregunta

Cada pregunta tiene un `type`, unas `instructions` y, en las de opción y puntuación, un conjunto de `criteria`. Sí/no. Devuelve `noul`: la probabilidad de que la respuesta sea sí. `criteria` con descripciones para `true` y `false` es opcional. Elige una de entre 2 y 20 opciones etiquetadas. Devuelve `choice`, `probabilities` por opción y `confidence`. Sitúa el estado en una escala ordenada de 2 a 10 niveles. Devuelve un `score` continuo (0 = primer nivel), `probabilities`, `legend` y `confidence`.

Errores

Los errores siempre tienen la misma estructura. Ramifica según `error.code`, no según el texto del mensaje. Reintenta `429`, `502` y `529` con backoff exponencial. No reintentes `401`, `402` ni `422` sin modificar la solicitud.

HTTP	Código	Significado
401	missing_api_key / invalid_api_key	Clave de API ausente, no válida o revocada
402	insufficient_credits	No hay suficientes créditos en el espacio de trabajo
422	invalid_request	JSON mal formado o preguntas no válidas
429	rate_limited	Se alcanzó el límite de frecuencia o de concurrencia
502	upstream_error	El proveedor del modelo falló o agotó el tiempo de espera
529	upstream_overloaded	El proveedor del modelo está sobrecargado

Créditos y límites

1 crédito son 1,000 tokens de entrada. El cargo final usa los tokens reales, redondeados hacia arriba, mínimo 1. Se reservan antes de la llamada y se devuelven si falla. La concurrencia y las solicitudes por minuto dependen del plan de tu espacio de trabajo. Si los superas, recibirás un `429` con un encabezado `Retry-After`.

Tratamiento de datos

Reenviamos la solicitud al modelo para obtener una respuesta y no guardamos el contenido. Conservamos metadatos (hora, estado, créditos y tokens) para tu historial de uso.