API de decisiones

Jev APIDecisiones que tu código puede ejecutar.

Envía contexto y preguntas tipadas. Recibe probabilidades y respuestas estructuradas para asignar, puntuar y automatizar. Prueba en el entorno de pruebas e integra con una sola solicitud API.

1 crédito por llamada con éxito · las llamadas fallidas son gratis

POST/api/v1/decisionsJSON
{  "model": "jev-1.13",  "state": "I was charged twice for my subscription.",  "questions": {    "refund": {      "type": "noul",      "instructions": "Is the customer asking for money back?"    }  }}

Solicitud de ejemplo · autentícate con tu clave API Bearer.

Tres tipos de respuesta

Noul, Choice y Score en una sola API.

Paga por llamadas exitosas

1 crédito por solicitud de decisión.

Encaja en tu stack actual

Solicitudes HTTP y compatibilidad con el SDK de TypeSafe.

Ejemplos

Ocho decisiones que puedes ejecutar

Pasa el cursor para ver la solicitud. Cópiala o ábrela en el playground.

Enrutar un checkout en blanco

Choice devuelve el equipo y la probabilidad de cada uno.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
Abrir en el playground

¿Pide un reembolso?

Noul devuelve la probabilidad de sí, no un párrafo.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
Abrir en el playground

Qué tan urgente es el fallo de pago

Score lo sitúa en tu escala y devuelve la distribución.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
Abrir en el playground

Petición de credenciales en un mensaje

La probabilidad Noul es la puerta antes de la revisión humana.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
Abrir en el playground

Calificar una nota entrante

Choice separa una ventana de compra de un simple interés.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
Abrir en el playground

Anuncio de rendimiento garantizado

Noul responde la pregunta de política que escribiste.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
Abrir en el playground

Riesgo de renovación en una nota

Score usa tus tres niveles, de poco probable a probable cancelación.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
Abrir en el playground

Qué excepción de factura

Choice puede marcar exceso de OC, una línea no pedida, o ambas.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
Abrir en el playground

Respuesta

Respuestas con las que tu código puede ramificar

Jev no escribe un párrafo para analizar. Devuelve la decisión pedida y su probabilidad.

Cada opción conserva su probabilidad

Choice nombra al ganador y aún devuelve la probabilidad de cada opción.

Noul, Choice y Score en una solicitud

Hasta seis preguntas comparten un estado y vuelven en una respuesta. Un sí/no, una elección etiquetada y una puntuación cuestan un viaje de ida y vuelta y un crédito.

Fija el modelo si el umbral importa

Envía jev-1.13 si ajustas un umbral. jev-latest sigue la versión que sirve esta API.

Cómo usarla

Cómo llamar a Jev API

  1. 01

    Crea una clave

    Entra y copia una clave del panel. El playground puede crear una para la cuenta.

  2. 02

    POST de estado y preguntas

    El cuerpo lleva model, state y un mapa de preguntas. Tus ids son etiquetas; el texto va en instructions.

  3. 03

    Ramifica sobre la respuesta tipada

    Lee noul, choice o score. En Choice y Score, confidence indica si las opciones están cerca.

Una integración clara

Conoce lo que vas a integrar.

Uso transparente

Cada solicitud de decisión exitosa cuesta 1 crédito. Los errores de validación y las solicitudes fallidas no consumen créditos. Consulta los planes antes de recargar.

Ver precios

Acceso documentado

Crea una clave API en tu panel. Planifica la integración con los esquemas de solicitud, ejemplos de respuesta y límites de la documentación.

Leer la documentación API

Contacto directo con soporte

Para ayuda con el acceso a la API, la integración o la facturación, escribe a [email protected]. Los datos están en nuestra página de contacto.

Contactar con soporte

Límites

Límites de Jev API en este endpoint

Lo que POST /api/v1/decisions acepta hoy.

ElementoEste endpoint
EndpointPOST /api/v1/decisions, clave Bearer
Modelojev-1.13 (jev-latest es un alias)
Preguntas por llamada1 a 6
Opciones de Choice2 a 8
Niveles de Score2 a 10, el más bajo primero
StateCadena, objeto JSON o array, hasta 60,000 caracteres
Facturación1 crédito por llamada con éxito; las fallidas son gratis
StreamingNo disponible

La propia API de TypeSafe es POST https://api.typesafe.ai/v1/systemone. Acepta ids versionados como jev-1.13.0, permite hasta 255 opciones de Choice y factura por token de entrada.

Referencia completa en Jev Docs

Preguntas frecuentes de Jev API

¿Qué es Jev API?

Jev API es cómo el software llama a Jev, el modelo System One de TypeSafe AI. Envías un estado y preguntas tipadas. Jev devuelve una probabilidad Noul, un Choice con probabilidad por opción o un Score en tu escala. No escribe texto.

¿Cómo consigo una clave de Jev API?

Entra y crea una clave en el panel. El playground puede crear una en tu primera ejecución, y la primera clave funciona de inmediato.

¿Cuánto cuesta una llamada a Jev API?

Un POST /api/v1/decisions con éxito usa 1 crédito, lleve una pregunta o seis. Los errores de validación y los fallos upstream no usan ninguno. Unos 100 créditos cuestan 1 USD antes de impuestos. Los planes están en la página de precios.

¿Es esta la API oficial de TypeSafe?

No. TypeSafe AI construye y sirve Jev. Este sitio es un servicio de API independiente: las claves, los créditos y el soporte vienen de este sitio, no de una cuenta de TypeSafe. Para la consola de TypeSafe y el precio por token, ve a typesafe.ai.

¿En qué se diferencia este endpoint de api.typesafe.ai/v1/systemone?

jev-api.org ahora expone ambos. POST /v1/systemone acepta el cuerpo de TypeSafe tal cual — model, state y questions — y funciona con los SDK de TypeSafe cambiando la base URL. POST /api/v1/decisions es el endpoint simple con límites más estrictos: de 1 a 6 preguntas, de 2 a 8 opciones de Choice y de 2 a 10 niveles de Score. En ambos, las claves vienen del panel de este sitio.

¿Cuál es la diferencia entre Noul, Choice y Score?

Noul es un sí/no con probabilidad. Choice elige una opción tuya y devuelve la probabilidad de cada una. Score sitúa el estado en tu escala, de menor a mayor.

Envía la primera decisión

Abre el playground con un ejemplo, o sigue Jev Docs y llama al endpoint con tu clave.