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.
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.
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.
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.
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))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.
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.
