Desarrolladores

Cómo usar la API Jev alojada

Un endpoint: envía state y questions tipadas, recibe respuestas estructuradas. Auth con jv_live_ de este sitio — tokens de entrada prepago, salida gratis. Las claves TypeSafe upstream quedan en nuestros servidores.

Referencia de origen:

Entrada oficial del blog de TypeSafe AI

Crear tu clave API →Ver precios

1. El endpoint

Cada llamada es un POST a https://jevtypesafe.org/api/v1/decide, con Bearer. Pon la clave en JEV_API_KEY (nunca la subas al repo).

Header: Authorization: Bearer jv_live_…
Header: Content-Type: application/json
Crea claves en Cuenta tras comprar un pack (o usar tokens mensuales gratis).

curl

curl https://jevtypesafe.org/api/v1/decide \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "Customer: I was charged twice and nobody has replied for 3 days.",
    "questions": {
      "route": {
        "type": "choice",
        "instructions": "Where should this go?",
        "criteria": { "billing": "money", "bug": "broken", "account": "login" }
      },
      "urgency": {
        "type": "score",
        "instructions": "How urgent is this?",
        "criteria": ["routine", "today", "urgent", "critical"]
      },
      "escalate": {
        "type": "noul",
        "instructions": "Escalate to a human now?"
      }
    }
  }'

Python

import os
import requests

resp = requests.post(
    "https://jevtypesafe.org/api/v1/decide",
    headers={
        "Authorization": f"Bearer {os.environ['JEV_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "state": "Customer: I was charged twice and nobody has replied for 3 days.",
        "questions": {
            "route": {
                "type": "choice",
                "instructions": "Where should this go?",
                "criteria": {"billing": "money", "bug": "broken", "account": "login"},
            },
            "urgency": {
                "type": "score",
                "instructions": "How urgent is this?",
                "criteria": ["routine", "today", "urgent", "critical"],
            },
            "escalate": {
                "type": "noul",
                "instructions": "Escalate to a human now?",
            },
        },
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

TypeScript

const res = await fetch("https://jevtypesafe.org/api/v1/decide", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JEV_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    state: "Customer: I was charged twice and nobody has replied for 3 days.",
    questions: {
      route: {
        type: "choice",
        instructions: "Where should this go?",
        criteria: { billing: "money", bug: "broken", account: "login" },
      },
      urgency: {
        type: "score",
        instructions: "How urgent is this?",
        criteria: ["routine", "today", "urgent", "critical"],
      },
      escalate: {
        type: "noul",
        instructions: "Escalate to a human now?",
      },
    },
  }),
});

if (!res.ok) throw new Error(await res.text());
console.log(await res.json());

Prueba tu clave — ejecuta esta misma petición contra el endpoint en vivo, una vez:

Envía la petición a https://jevtypesafe.org/api/v1/decide con tu clave y cobra una decisión pequeña (≈ $0.0004 media). La clave no sale del navegador. En producción, guárdala en el servidor.

2. Cuerpo de la petición

Dos campos obligatorios:

state — texto de contexto (ticket, email, reseña…). Máx. 4000 caracteres.
questions — mapa nombre → objeto pregunta. Todas comparten el state en un solo viaje.

3. Los tres tipos de pregunta

choice — elegir una opción

Pasa un mapa criteria etiquetado. La respuesta incluye la clave ganadora, probabilidades y confianza.

choice

"topic": {
  "type": "choice",
  "instructions": "What is the primary issue?",
  "criteria": {
    "billing": "billing or payment problem",
    "bug": "the product is broken",
    "account": "login or access"
  }
}

score — posición en una escala

Pasa un array criteria ordenado (2–10 niveles). Devuelve score numérico y distribución.

score

"severity": {
  "type": "score",
  "instructions": "How urgent is this?",
  "criteria": [
    "routine",
    "handle today",
    "urgent",
    "critical, about to churn"
  ]
}

noul — sí/no calibrado

Sin criteria — solo instructions. Probabilidad en [0, 1].

noul

"escalate": {
  "type": "noul",
  "instructions": "Escalate to a human immediately?"
}

4. La respuesta

Respuestas tipadas: ramifica en código sin parsear JSON en strings. Forma ejemplo:

response

{
  "model": "jev-latest",
  "answers": {
    "route": {
      "type": "choice",
      "choice": "billing",
      "confidence": 1.0,
      "probabilities": { "billing": 1.0, "bug": 0.0, "account": 0.0 }
    },
    "urgency": {
      "type": "score",
      "score": 2.0,
      "confidence": 0.9,
      "probabilities": { "0": 0.05, "1": 0.1, "2": 0.7, "3": 0.15 }
    },
    "escalate": { "type": "noul", "noul": 0.72 }
  },
  "usage": { "input_tokens": 180, "output_tokens": 40 }
}

usage.input_tokens se descuenta del saldo prepago. Los tokens de salida son gratis.

5. Límites y prácticas

Límite ≈ 60/min por clave (más caps IP / cuenta / global).
Techos blandos ≈ 2.000.000 tokens/hora y 20.000.000 tokens/día por cuenta.
Recorta el state — pagas por token de entrada.
Agrupa varias preguntas en una llamada para compartir el coste del state.
Usa umbrales de confianza / noul para auto-gestionar casos fáciles y escalar el resto.

Acceso al instante

Inicia sesión, compra un pack en Precios, crea jv_live_ en Cuenta y llama a este endpoint. Un saldo para Core decide y todas las tools.

Crear tu clave API →Ver precios