DOCS

Jev API: de la primera decisión a tu integración

Clasifica mensajes con tus propias etiquetas y recibe un resultado estructurado. Jev API Pro es un espacio independiente que accede a Jev de TypeSafe mediante OpenRouter, con cuentas, créditos y claves propios.

Probar una decisión ↗Mi espacioPrecios
POST /api/v1/decisions
curl --fail-with-body --connect-timeout 5 --max-time 35 \
  https://jevapi.pro/api/v1/decisions \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: ticket-123-v1' \
  -d '{
    "text": "I was charged twice this month.",
    "instructions": "Choose the responsible team.",
    "labels": ["billing", "technical", "account"],
    "threshold": 0.85
  }'

Ejemplo de integración. Sustituye YOUR_API_KEY por una clave guardada en tu servidor.

Tu aplicación envía una petición delimitada; Jev devuelve una respuesta tipada; tu política controla la acción.
Tu aplicación envía una petición delimitada; Jev devuelve una respuesta tipada; tu política controla la acción.

Qué es Jev y cuándo usar su API

Jev es un modelo de decisiones de TypeSafe. Recibe contexto para una pregunta delimitada y devuelve una respuesta tipada. Una primera tarea útil es asignar un ticket a facturación, soporte técnico o acceso. Tu aplicación decide qué hacer después.

TypeSafe lo denomina modelo System One. Un modelo de chat puede redactar explicaciones o planificar tareas; esta API sirve para obtener categorías, puntuaciones o juicios de tipo sí/no. No navega ni ejecuta herramientas. Compara resultados con tus propios ejemplos, sin asumir ventajas universales de coste, velocidad o precisión.

Documentación del modelo de TypeSafe · Qué es Jev

Prueba una decisión antes de crear la clave

Abre el área de pruebas, elige soporte, contactos o comentarios, y cambia el mensaje y las etiquetas. Ver el ejemplo ilustrativo no llama al modelo. Ejecutar una decisión real es una acción distinta, sujeta a los límites de prueba y la disponibilidad.

Usa ejemplos anonimizados y suficiente contexto para distinguir las etiquetas. Reserva otros ejemplos para evaluar: una respuesta convincente no demuestra la precisión del sistema.

Prueba Jev

Obtén tu clave de Jev API

Accede a este espacio, elige un plan con acceso API activo y crea una clave con nombre en tu panel. Copia el secreto cuando se muestre y guárdalo en el servidor. Una clave de TypeSafe, OpenRouter u otra comunidad no es una clave de Jev API Pro.

Envíala en Authorization: Bearer. Una cookie de inicio de sesión no autoriza REST. Nunca pongas secretos en JavaScript del navegador, repositorios públicos, prompts o archivos Skill. Revoca las claves expuestas o que ya no uses.

Panel y claves API · Planes con acceso API

Envía la solicitud y lee la respuesta

El ejemplo curl anterior llama a POST https://jevapi.pro/api/v1/decisions. Sustituye YOUR_API_KEY por tu clave de servidor. Envía text, instructions, labels distintos y threshold. Usa una Idempotency-Key nueva para cada decisión distinta; reutilízala solo para la misma solicitud sin cambios.

Una decisión nueva devuelve HTTP 201. choice contiene la etiqueta y needsReview indica revisión. confidence puede ser null si el proveedor no la devuelve: no lo conviertas en certeza. Conserva id para soporte. La referencia completa describe límites, preguntas múltiples y campos de respuesta.

Referencia completa de solicitudes y respuestas

Llama a Jev API desde JavaScript (Node.js)

La misma solicitud desde un script de servidor con Node.js 18 o superior y el fetch integrado. Guárdalo como classify.mjs, define JEV_API_KEY con la clave de tu cuenta y JEV_IDEMPOTENCY_KEY con un valor nuevo de 8 a 100 caracteres, por ejemplo un UUID, y ejecuta node classify.mjs. Un error HTTP detiene el script con el código y el mensaje, sin leer una respuesta parcial.

// Node.js 18+ (built-in fetch). Run on your server, never in the browser.
const apiKey = process.env.JEV_API_KEY?.trim();
const requestKey = process.env.JEV_IDEMPOTENCY_KEY?.trim();
if (!apiKey) throw new Error('JEV_API_KEY must not be empty');
if (!requestKey || requestKey.length < 8 || requestKey.length > 100) throw new Error('JEV_IDEMPOTENCY_KEY must be 8-100 characters');

const response = await fetch('https://jevapi.pro/api/v1/decisions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestKey,
  },
  body: JSON.stringify({
    text: 'I was charged twice this month.',
    instructions: 'Choose the responsible team.',
    labels: ['billing', 'technical', 'account'],
    threshold: 0.85,
  }),
  signal: AbortSignal.timeout(35_000),
});
const answer = await response.json();
if (!response.ok) throw new Error(`${response.status} ${answer.error?.code}: ${answer.error?.message}`);
console.log({ id: answer.id, choice: answer.choice, needsReview: answer.needsReview, confidence: answer.confidence });

Llama a Jev API desde Python

Instala el cliente con python -m pip install requests, define las mismas dos variables de entorno, guarda el ejemplo como classify.py y ejecuta python classify.py. Se detiene ante errores HTTP antes de leer una respuesta correcta y muestra el id de la decisión, la elección y la marca de revisión.

import json
import os
import requests

api_key = os.environ["JEV_API_KEY"].strip()
request_key = os.environ["JEV_IDEMPOTENCY_KEY"].strip()
if not api_key:
    raise ValueError("JEV_API_KEY must not be empty")
if not 8 <= len(request_key) <= 100:
    raise ValueError("JEV_IDEMPOTENCY_KEY must be 8-100 characters")

payload = {
    "text": "I was charged twice for the same order.",
    "instructions": "Choose the team responsible for this request.",
    "labels": ["Billing", "Support", "Access"],
    "threshold": 0.85,
}
response = requests.post(
    "https://jevapi.pro/api/v1/decisions",
    headers={
        "Authorization": "Bearer " + api_key,
        "Idempotency-Key": request_key,
    },
    json=payload,
    timeout=(5, 30),
)
response.raise_for_status()
answer = response.json()
print(json.dumps({
    "id": answer["id"],
    "choice": answer["choice"],
    "needsReview": answer["needsReview"],
}, ensure_ascii=False, indent=2))

Guía de clasificación de texto con Python

Conecta un agente con REST o MCP

Mantén el modelo principal y los permisos de herramientas de tu agente. Cuando deba elegir una ruta, llama desde tu servidor al mismo endpoint con la tarea, instrucciones explícitas y resultados permitidos como continuar o revisar. Valida la elección antes del siguiente paso.

Si needsReview es true, falta confianza o falla la solicitud, utiliza revisión. Una predicción no autoriza reembolsos, mensajes ni eliminaciones. Aplica esas reglas en tu aplicación. También ofrecemos MCP en https://jevapi.pro/api/mcp y Skills descargables. Usa la clave de este espacio; las claves de otros sitios no son intercambiables.

{
  "text": "Task: read a public API guide and summarize its supported request fields. No account changes or external messages are requested.",
  "instructions": "Choose review if the task is unclear or could change external state. Otherwise choose proceed. This classification never grants permission to execute a tool.",
  "labels": [
    "proceed",
    "review"
  ],
  "threshold": 0.9
}

MCP · Skills · Revisión humana

Recupera errores sin duplicar trabajo

Corrige entradas en un 400, revisa clave y acceso en 401/403, y créditos en 402. Ante 429 respeta Retry-After si aparece y limita los reintentos. Una caída del proveedor debe activar una alternativa visible.

La misma clave y el mismo cuerpo recuperan una decisión completada sin cobrarla de nuevo. Cambiar el cuerpo produce 409. Repetir una solicitud registrada como fallida también devuelve 409: resuelve la causa y usa otra clave para un nuevo intento deliberado. Si un timeout deja el resultado desconocido, consulta primero con la misma clave.

Códigos de error

Precios de Jev API y siguiente paso

Jev API Pro ofrece periodos prepagados con créditos de decisión, no la tarifa directa por tokens del proveedor. Consulta precios, créditos, duración y condiciones actuales en la página de planes. Una compra aquí no añade saldo a TypeSafe ni OpenRouter.

Prueba tu tarea antes de pagar. Antes de producción, comprueba entradas ambiguas, confianza ausente, claves vencidas y fallos del proveedor. Empieza con sugerencias revisables y automatiza solo lo que respalde tu evaluación.

Precios y créditos de Jev API · Seguridad y datos

Probar una decisión ↗

Continúa tu proceso

Guías

¿Qué es Jev AI?

Jev es un modelo de decisiones estructuradas de TypeSafe al que se accede mediante OpenRouter. Evalúa contexto y preguntas y devuelve respuestas tipadas con probabilidades, en lugar de redactar una conversación.

Leer la guía ↗
BONO DIARIO

2 créditos gratis cada día

Reclama 2 créditos gratis por día UTC: 14 en siete días de recogida. No hace falta comprar. Los créditos no caducan.

    Se reinicia a las 00:00 UTC. No se requiere una racha.

    Probar una decisión →

    Lleva la prueba a tu espacio.

    1 intento anónimo al día · 20 créditos de registro · Prueba sin tarjeta

    Acceder ↗

    Cuéntanos qué necesitas

    Describe el proceso que quieres clasificar, el volumen previsto y el resultado que necesitas. Respondemos por correo.

    10–2.000 caracteres. No incluyas contraseñas, claves API ni datos de pago.