API de decisiones

Envía contexto y una pregunta. Recibe una decisión estructurada.

Crea una clave API en la configuración de tu cuenta y compra créditos. Envía Authorization: Bearer YOUR_API_KEY y un Idempotency-Key único por decisión. El uso se cobra al propietario de la clave; nunca la expongas en el navegador.

Un ejemplo de API Jev para tu próxima integración

Llama a la API REST de iajev con cURL. Recibe una opción, probabilidades y confianza en JSON.

Leer la documentación de la API de iajev

Solicitud

curl https://iajev.com/api/v1/decisions/run \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -H 'Content-Type: application/json' \
  --data '{
  "state": {
    "message": "Me cobraron dos veces la suscripción del mes pasado y todavía no recibo mi reembolso.",
    "plan": "pro",
    "country": "MX"
  },
  "decision": {
    "type": "choice",
    "question": "¿Qué equipo debe atender esta solicitud?",
    "choices": [
      "Facturación",
      "Soporte técnico",
      "Ventas",
      "Fraude"
    ]
  }
}'

Campos de la solicitud

state.message: Texto obligatorio; de 1 a 8,000 caracteres.
state.<field>: Hasta 5 campos opcionales además de message. Nombres: de 1 a 40 caracteres. Valores: texto de hasta 300 caracteres, un número finito o un booleano. No se admiten objetos anidados.
decision.type: Usa "choice". Esta API aún no admite solicitudes de puntuación ni booleanas.
decision.question: Texto obligatorio; de 1 a 300 caracteres.
decision.choices: Entre 2 y 8 cadenas únicas no vacías; hasta 80 caracteres cada una.

Campos de la respuesta

decision: La opción seleccionada.
confidence: Una estimación independiente de confianza entre 0 y 1.
results: Cada opción y su probabilidad, de mayor a menor.
meta: Latencia en milisegundos e ID de solicitud para diagnóstico.
billing: Créditos cobrados, inputTokens y outputTokens de esta solicitud.

Errores y límites

400: Datos inválidos o falta Idempotency-Key.
401: Clave API ausente, inválida, vencida o revocada.
402: Créditos disponibles insuficientes.
409: Solicitud en proceso, fallida o clave de idempotencia reutilizada con otros datos.
403: Cuenta sin verificar o deshabilitada.
413: La solicitud supera 16,000 bytes UTF-8, incluidos todos los campos.
415: Content-Type debe ser application/json.
429: Se alcanzó el límite de la clave API. Respeta el encabezado Retry-After.
502 / 503 / 504: Decisión no disponible o tiempo agotado. Evita reintentos inmediatos repetidos.

Estructura de respuesta

{
  "decision": "Billing",
  "confidence": 0.8,
  "results": [
    { "value": "Billing", "probability": 0.87 },
    { "value": "Technical", "probability": 0.10 },
    { "value": "Sales", "probability": 0.02 },
    { "value": "Fraud", "probability": 0.01 }
  ],
  "meta": { "latencyMs": 218, "requestId": "…" },
  "billing": { "credits": 1, "inputTokens": 380, "outputTokens": 0 }
}

Consultar créditos disponibles

curl https://iajev.com/api/v1/credits -H 'Authorization: Bearer YOUR_API_KEY'

Cada solicitud de pago reserva temporalmente 32 créditos y después cobra 1 crédito por cada bloque iniciado de 1,000 tokens de entrada (mínimo 1). Los créditos no usados se liberan y los fallos no se cobran. Conserva el mismo Idempotency-Key al reintentar después de un error de conexión. HTTP 409 REQUEST_PENDING indica que debes esperar y reintentar con la misma clave; REQUEST_FAILED requiere una nueva. Reutilizar una clave con datos distintos devuelve 409.

No incluyas secretos ni datos personales innecesarios. El contexto se envía para inferencia. Las solicitudes con sesión y por API guardan datos, resultados y facturación en tu historial privado. Las decisiones guardadas también conservan el contexto. La prueba anónima solo registra contadores de límites, sin historial de decisiones.