Cuenta de jevmodel.org

Inicia sesión y obtén 100.000 tokens de entrada gratis

Unas 500 peticiones a Jev en el Playground o desde tu propio código con una API key. Los paquetes empiezan en $9,90 cuando necesites más. Sin tarjeta.

Al iniciar sesión aceptas nuestros términos. Solo usamos tu correo para tu cuenta.
Jev Model · Referencia para desarrolladores

Documentación de la API de Jev

Llama a la API de decisiones Jev alojada con un state y un conjunto de preguntas tipadas — recibe una opción, una puntuación y probabilidades sí/no sobre las que tu código puede ramificar. Esta referencia cubre el formato del wire, los campos de respuesta, la facturación, el manejo de errores y el servidor MCP remoto para agentes.

URL base https://jevmodel.org Endpoint de evaluación POST /v1/systemone · POST /mcp

Visión general

Jev evalúa un state — un ticket de soporte, un registro de chat, una llamada a herramienta, cualquier texto o JSON — contra un conjunto de preguntas tipadas y devuelve respuestas estructuradas sobre las que tu código puede ramificar. No genera texto.

Una petición puede formular hasta 8 preguntas; se evalúan juntas y comparten el coste de entrada del state. El cuerpo de la petición tiene la misma forma que acepta la API SystemOne de TypeSafe — para migrar una integración que funciona, cambia la URL base y la clave Bearer.

  • POST https://jevmodel.org/v1/systemone — el único endpoint de decisiones.
  • CORS está abierto (access-control-allow-origin: *), el endpoint responde desde cualquier origen. Mantén tu clave en un servidor de todos modos.
  • El playground envía exactamente la misma petición a través de tu sesión de navegador — lo que previsualizas ahí es lo que envías.

Autenticación

Cada llamada a la API necesita una clave de jevmodel.org. Créala en Dashboard → API keys; las claves empiezan por sk- y se muestran una sola vez al crearlas. Guárdala como variable de entorno, por ejemplo JEVMODEL_API_KEY.

Cabecera Authorization
Authorization: Bearer $JEVMODEL_API_KEY

Las claves pertenecen al saldo de tokens de tu cuenta y pueden revocarse desde el dashboard. Nunca pongas una clave en código del lado del cliente ni la subas a un repositorio — si se filtra, revócala y genera otra. El playground se autentica con tu sesión de navegador y no necesita clave.

Endpoint HTTP

Envía un cuerpo JSON al endpoint de evaluación con autenticación Bearer:

Petición HTTP
POST /v1/systemone HTTP/1.1
Host: jevmodel.org
Authorization: Bearer $JEVMODEL_API_KEY
Content-Type: application/json
Idempotency-Key: ticket-4821-run-1   # optional

Idempotency-Key es opcional (hasta 100 caracteres). Los reintentos con la misma clave reutilizan el registro de facturación original, así que una petición reintentada no se cobra dos veces por la misma entrada.

Ejemplo cURL completo
curl -X POST https://jevmodel.org/v1/systemone \
  -H "Authorization: Bearer $JEVMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "The customer has been billed twice and wants a refund today.",
    "questions": {
      "route": {
        "type": "choice",
        "instructions": "Which queue should own this ticket?",
        "criteria": {
          "billing": "Payments, refunds, invoices",
          "technical": "Product errors and usage problems",
          "sales": "Pricing, upgrades, new business"
        }
      },
      "escalate": {
        "type": "noul",
        "instructions": "Does this need a human right now?"
      },
      "urgency": {
        "type": "score",
        "instructions": "How urgent is this for the customer?",
        "criteria": ["routine", "soon", "urgent", "critical"]
      }
    }
  }'

Cuerpo de la petición

Un objeto JSON con un state y un mapa de preguntas:

Cuerpo de la petición
{
  "model": "jev-latest",
  "state": "The customer has been billed twice and wants a refund today.",
  "questions": {
    "route": {
      "type": "choice",
      "instructions": "Which queue should own this ticket?",
      "criteria": {
        "billing": "Payments, refunds, invoices",
        "technical": "Product errors and usage problems",
        "sales": "Pricing, upgrades, new business"
      }
    },
    "escalate": {
      "type": "noul",
      "instructions": "Does this need a human right now?"
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this for the customer?",
      "criteria": ["routine", "soon", "urgent", "critical"]
    }
  }
}
CampoTipoNotas
modelstringOpcional; por defecto jev-latest.
statestring, object o arrayObligatorio. La forma serializada admite hasta 1.000.000 caracteres.
questionsobjectMapa obligatorio de 1–8 nombres de pregunta a definiciones tipadas. Los nombres son identificadores: letras, dígitos y _, máximo 64 caracteres.
assetsobjectOpcional (experimental). Hasta 4 imágenes PNG/JPEG con un nombre de referencia que se escribe dentro de state, instructions o criteria. Ver Imágenes y Box.

Cada pregunta necesita un type e instructions (hasta 1.800 caracteres) indicando al modelo qué decidir. criteria aporta el espacio de respuesta — obligatorio para choice y score, opcional para noul.

Tipos de pregunta

Elige la forma de respuesta que tu aplicación pueda usar.

TipoCriteriaRespuesta
noulDescripciones opcionales de las etiquetas true / false.noul — la probabilidad de sí, de 0 a 1.
choiceObjeto de 2–20 claves de opción con descripciones.choice seleccionada, un mapa probabilities y confidence.
scoreArray ordenado de 2–10 niveles.score numérico (puede ser fraccionario) y confidence.
boxNo se usa — solo instructions.box con bordes normalizados (top/bottom/left/right, 0–1) y confidence. Experimental; requiere jev-preview.

Los criteria serializados admiten hasta 2.000 caracteres por pregunta. Los fallos de validación devuelven 422 antes de reservar tokens — las peticiones incorrectas nunca se cobran.

Imágenes y Box (experimental)

Jev 1.14 acepta imágenes PNG y JPEG como entrada para decisiones — comprensión de imágenes, no generación. Adjunta cada imagen en assets con un nombre de referencia y escribe esa referencia dentro de state, en las instructions de una pregunta o en criteria; la referencia se resuelve a la imagen en esa posición. Las solicitudes con imágenes o Box necesitan el modelo de vista previa — usa jev-preview en model.

Solicitud con imagen
{
  "model": "jev-preview",
  "state": "Shipment photo attached as img-1.",
  "assets": {
    "img-1": { "type": "image", "format": "jpg", "data_base64": "/9j/4AAQSkZJRg…" }
  },
  "questions": {
    "damage_visible": {
      "type": "noul",
      "instructions": "Is there visible damage to the package in img-1?"
    },
    "damage_region": {
      "type": "box",
      "instructions": "Locate the damaged area in img-1"
    }
  }
}
  • assets asigna una referencia a { "type": "image", "format": "png|jpg", "data_base64": "…" } — máximo 4 imágenes, ~4 MB cada una tras codificar.
  • Cada asset debe estar referenciado y cada uso se factura — las imágenes cuentan para usage.input_tokens igual que el texto.
  • box solo toma instructions y siempre devuelve una caja — combínalo con una pregunta noul como «¿se ve X?» cuando el objetivo pueda no existir.
  • Es una superficie experimental opt-in: el proxy aplica el header upstream automáticamente cuando la solicitud lleva assets o una pregunta box. No se admiten subidas multipart — envía base64.

Audio y vídeo siguen sin soporte — conviértelos primero a texto o datos estructurados.

JSON de respuesta

Una respuesta 200 es la salida del modelo en sí: el modelo resuelto, una respuesta por nombre de pregunta y el uso. Los valores de abajo son ilustrativos — ejecuta la petición para una salida real.

Respuesta 200 ilustrativa
{
  "model": "jev-latest",
  "answers": {
    "route": {
      "type": "choice",
      "choice": "billing",
      "probabilities": { "billing": 0.93, "technical": 0.05, "sales": 0.02 },
      "confidence": 0.93
    },
    "escalate": {
      "type": "noul",
      "noul": 0.12
    },
    "urgency": {
      "type": "score",
      "score": 1.4,
      "confidence": 0.88
    }
  },
  "usage": { "input_tokens": 136, "output_tokens": 18 }
}
  • answers va indexado por tus nombres de pregunta — lees los campos que pediste.
  • En choice, ramifica por la etiqueta seleccionada e inspecciona probabilities cuando necesites la distribución completa.
  • noul es P(sí) — tu código decide el umbral de acción.
  • usage.input_tokens es lo que esta llamada cobró realmente; los tokens de salida son gratis.

Facturación

La API cobra solo tokens de entrada — la salida es gratis. Cada llamada se cobra según los usage.input_tokens reales que informa el modelo. Con tokens gratuitos se reserva una estimación por adelantado y luego se liquida a esa cifra. Si Jev falla en el upstream, no se cobra nada.

  • Inicia sesión una vez y recibe 100.000 tokens de entrada gratis; los paquetes de pago empiezan en $9,90 y no caducan.
  • Saldo insuficiente devuelve 402 antes de llamar a Jev.
  • X-Tokens-Remaining en cada respuesta 200 es tu saldo tras la liquidación.
  • Estímalo tú mismo: Σ ceil((state + question).length / 4): el state cuenta una vez por pregunta.

Modelos y límites

jev-latest es el modelo por defecto y el que se sirve actualmente — el campo model es opcional. Las variantes Laya del playground están anunciadas y aún no están expuestas en este endpoint.

LímiteValor
Preguntas por petición8
Nombre de preguntaIdentificador ≤ 64 caracteres
state serializado1.000.000 caracteres
instructions por pregunta1.800 caracteres
Opciones de choice / niveles de score2–20 opciones, 2–10 niveles
criteria serializados2.000 caracteres por pregunta
Límite de tasa120 peticiones / minuto por clave
Imágenes por solicitud (assets)4
Formato / tamaño de imagenPNG o JPEG en base64, ≤ ~4 MB cada una
Dimensiones de imagen256–1.568 px por lado

Estas cifras describen el validador de la API; el modelo upstream puede tener sus propios límites de contexto.

Errores y reintentos

Los errores devuelven un sobre JSON con un type legible por máquina y un message para humanos:

Respuesta de error
{
  "error": {
    "type": "invalid_request_error",
    "message": "At most 8 questions per request."
  }
}
EstadoTipoCausa¿Cobrado?
401authentication_errorClave ausente, inválida o revocada.No
402insufficient_creditsLos tokens de entrada estimados superan tu saldo.No
422invalid_request_errorEl cuerpo no pasó la validación — ver message.No
429rate_limit_errorMás de 120 peticiones este minuto.No
502upstream_errorJev no pudo completar la llamada.No — reembolsado

Reintenta 429 y 502 con backoff exponencial — la ventana de tasa es por minuto, así que pausas cortas suelen bastar. Envía un Idempotency-Key al reintentar para que una petición repetida liquide contra el mismo registro de facturación en vez de cobrar dos veces.

Servidor MCP para agentes

jevmodel.org también ejecuta un servidor MCP remoto sobre Streamable HTTP en https://jevmodel.org/mcp. Expone cuatro herramientas — jev_decide (el contrato completo de state más questions), jev_noul, jev_choice y jev_score — para que agentes de código como Claude Code, Cursor o Cline llamen a Jev sin escribir HTTP.

Claude Code
claude mcp add --transport http jev https://jevmodel.org/mcp \
  --header "Authorization: Bearer $JEVMODEL_API_KEY"
  • Misma clave Authorization: Bearer sk-… y mismo saldo de tokens que esta API — tools/call cobra solo tokens de entrada.
  • initialize, ping y tools/list no requieren autenticación; solo tools/call usa tu clave.
  • GET /mcp devuelve una tarjeta JSON de descubrimiento para agentes y humanos.

Los comandos de configuración para Claude Code y Cursor, y la skill de agente a juego (manual de juicio), están en la página de herramientas de agente.

Guía de herramientas de agente

Del playground a la API

Construye primero el escenario en el playground — la vista previa de la petición muestra el cuerpo JSON exacto que tu aplicación debe enviar, y Copy API example te da el cURL correspondiente. Cuando las respuestas convenzan, crea una clave en el dashboard y cambia la sesión del navegador por autenticación Bearer.

Más lectura: Cómo usar Jev recorre una primera llamada de principio a fin, y Ejemplos de la API de Jev tiene patrones de producción para cada tipo de pregunta.

API keys

Llama a Jev con tu key.

Envía el estado y preguntas tipadas al endpoint de Jev. Las solicitudes correctas solo consumen tokens de entrada. Añade un encabezado Idempotency-Key al reintentar.

+ Nueva key