API de decisiones

Jev API para decisiones tipadas en tu código

Jev es el modelo System One de TypeSafe AI. Devuelve Noul, Choice o Score con probabilidades en lugar de texto. Consigue una clave aquí y llámalo con un POST, sin lista de espera.

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

2 llamadas gratis para cuentas nuevas · 1 crédito por llamada con éxito · las llamadas fallidas son gratis

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.

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. Las cuentas nuevas reciben 2 créditos, que cubren 2 llamadas con éxito. No hay lista de espera.

¿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?

El cuerpo tiene la misma forma: model, state y questions de tipo noul, choice o score. Aquí la ruta es /api/v1/decisions, la clave viene del panel de este sitio y el id del modelo es jev-1.13 o jev-latest. Los límites son más estrictos: de 1 a 6 preguntas, de 2 a 8 opciones de Choice y de 2 a 10 niveles de Score.

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