Introducción
Proporciona la evidencia en state y define preguntas con noul, choice o score. Cada pregunta evalúa ese contenido de manera independiente y la tarea devuelve las respuestas bajo los nombres que asignaste. Mantén la solicitud completa dentro de 64k tokens y state más cada pregunta dentro de 32k.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Datos estructurados |
| Editor y modelo | TypeSafe — Jev 1.14 (jev-1.14.0) |
| Fecha de lanzamiento | 14 de octubre de 2026; versión anterior Jev 1.13 |
| Nombre público de la API | typesafe/jev-1.14/decision |
| Entrada de state | Cadena, objeto JSON o arreglo JSON |
| Tipos de pregunta | noul, choice y score |
| Preguntas por llamada | Hasta 64, independientes y en paralelo |
| Límites de contexto | 64k tokens por solicitud; 32k para state más una pregunta |
| Opciones de choice | 1–255 opciones con nombre y descripción |
| Escala de score | 2–10 niveles ordenados, de menor a mayor |
| Salida de la tarea | output.decision contiene respuestas e inputTokens |
| Latencia observada | Unos 0,6 s en nuestras llamadas; medición previa de 0,62 s |
| Unidad de facturación | Tokens de entrada medidos; tokens de salida sin costo |
Funciones y aspectos destacados
Una probabilidad, una categoría o una escala
Selecciona entre 3 tipos de pregunta según el valor que necesite tu código. noul devuelve una probabilidad de sí entre 0–1; choice, una opción con nombre, confianza y probabilidades por opción; score, un nivel ponderado por probabilidad con confianza, una leyenda y probabilidades por nivel.
Un contenido, juicios independientes
Hasta 64 preguntas evalúan el mismo state de forma independiente y en paralelo, con pocos cambios de latencia al agregar preguntas. Consulta a la vez el equipo, la urgencia y la intención de reembolso de un ticket, y combina las respuestas en la lógica de tu aplicación.
Observa la incertidumbre junto a la respuesta
Nuestra revisión de un video corto devolvió un puntaje de evidencia de 1,44 con una confianza de 0,28, mientras que la probabilidad de oferta fue de 0,98. Son juicios distintos: detectar una oferta con claridad no implica que la evidencia de una afirmación sobre el producto sea igual de clara.
Conserva las reglas de escalamiento en tu código
Define los umbrales de probabilidad y confianza que envían un elemento a una persona o a un modelo generativo. Jev 1.14 entrega juicios estructurados sin justificación escrita; revisa la evidencia original cuando una respuesta incierta afecte la siguiente acción.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
questions | Sí | Asigna nombres a un máximo de 64 preguntas y añade type e instructions a cada una; usa criteria para 1–255 opciones de choice o 2–10 niveles de score ordenados de menor a mayor,… |
state | Sí | Proporciona una cadena, objeto JSON o arreglo con la evidencia para todos los juicios; las preguntas no pueden depender de la respuesta de otra. mínimo 1 caracteres |
Precios
$0.0000504 / 1.000 tokens
Se cobra por token de entrada medido; los tokens de salida son gratuitos. La reserva inicial se calcula con el límite de 64k tokens por solicitud y la diferencia se libera al liquidarse la solicitud.
Casos de uso
Revisa textos publicitarios de videos cortos
Proporciona como state la transcripción de un clip de producto, el texto en pantalla y descripciones de fotogramas; pregunta por el tipo de gancho, la evidencia y la oferta. El ejemplo mostrado devolvió problem como gancho, evidencia de 1,44 y probabilidad de oferta de 0,98; utilizó 537 tokens de entrada.
Dirige un ticket de soporte de facturación
Envía un mensaje como «Me cobraron después de cancelar; solicito el reembolso de la renovación» con los datos pertinentes de la cuenta. Pide equipo, urgencia e intención de reembolso; nuestro ejemplo de soporte devolvió billing, urgencia de 1,6 y refund_requested de 0,96 con 422 tokens de entrada.
Separa el sentimiento de una reseña de su intención
Con una reseña como «El acabado se desprendió, pero volvería a comprar si lo corrigen», pregunta por separado por sentimiento, problema e intención de regresar. Nuestro ejemplo produjo sentimiento de 1,45, quality como problema y would_return de 0,97 con 435 tokens de entrada.
Comprueba una ficha antes de publicarla
Envía el título, la descripción y los campos obligatorios de una ficha; pregunta si el título concuerda con la descripción y si aparece un dato requerido. Usa las probabilidades de sí/no para controlar la publicación y reserva las fichas ambiguas para una persona.
Puntúa un prospecto antes de escalarlo
Pasa una consulta como «Necesitamos implementar esto para el equipo el próximo mes» junto con los campos de empresa y fechas proporcionados. Define niveles ordenados de calificación y pregunta si falta información; utiliza puntajes e incertidumbre para decidir qué prospectos necesitan seguimiento con un modelo generativo.
Guía de prompts y consejos prácticos
Prepara el contenido compartido
Coloca el ticket, la transcripción o la reseña en state como cadena, objeto JSON o arreglo. Incluye la evidencia necesaria para cada pregunta, ya que ninguna puede leer las respuestas de las demás.
Define preguntas tipadas
Asigna a cada pregunta un nombre, un tipo e instructions; agrega criteria para describir las opciones de choice o los niveles ordenados de score. Elige noul para una probabilidad de sí/no, choice para una categoría o score para una escala.
Llama al endpoint de decisión
Envía POST /api/v1/jobs/createTask?wait=30 con model en typesafe/jev-1.14/decision e input con state y questions. Lee output.decision cuando termine la tarea, o crea la tarea y consulta recordInfo periódicamente.
Valida y dirige las respuestas
Compara probabilidades y confianza con etiquetas humanas de tu propia muestra antes de definir umbrales. Envía los casos inciertos a revisión y registra inputTokens junto con las decisiones.
Jev 1.14 API para decisiones tipadas
Jev 1.14 es el modelo de decisión System One de TypeSafe para clasificar y puntuar texto o JSON. Este endpoint devuelve probabilidades de sí/no, opciones con nombre y puntajes según una escala sin generar prosa ni razonamiento escrito. Aplica las respuestas al enrutamiento de soporte, las verificaciones de reseñas y el escalamiento.
Envía una solicitud de decisión
Llama a POST /api/v1/jobs/createTask?wait=30 con el nombre público typesafe/jev-1.14/decision. Esta solicitud ilustrativa de facturación es distinta de nuestro ejemplo medido.
{
"model": "typesafe/jev-1.14/decision",
"input": {
"state": {
"message": "I cancelled before renewal but was charged again. Please refund it today."
},
"questions": {
"team": {
"type": "choice",
"instructions": "Which team should handle this message?",
"criteria": {
"billing": "Charges, renewals and refunds",
"technical": "Product errors and access problems"
}
},
"urgency": {
"type": "score",
"instructions": "How urgently does this message request action?",
"criteria": ["No time pressure", "Action requested soon", "Immediate action requested"]
},
"refund_requested": {
"type": "noul",
"instructions": "The customer is asking for money back",
"criteria": {
"true": "A refund or repayment is requested",
"false": "No refund or repayment is requested"
}
}
}
}
}
Lee la salida de la tarea
Los resultados completados incluyen output.decision.answers y output.decision.inputTokens. También puedes crear la tarea y consultar recordInfo periódicamente. Este fragmento contiene campos seleccionados de nuestra respuesta medida de clasificación de soporte.
{
"output": {
"decision": {
"answers": {
"team": {"choice": "billing", "confidence": 1.0},
"urgency": {"score": 1.6, "confidence": 0.4},
"refund_requested": {"noul": 0.96}
},
"inputTokens": 422
}
}
}
Parámetros y tipos de respuesta
state aporta evidencia compartida para hasta 64 preguntas que se evalúan de forma independiente y en paralelo.
| Campo | Valor admitido | Uso práctico |
|---|---|---|
state | Cadena, objeto JSON o arreglo | Identifica los campos de evidencia |
questions | Objeto cuyas claves son nombres elegidos por quien llama | Asocia respuestas con verificaciones |
type | noul, choice, score | Selecciona probabilidad de sí, categoría o puntaje ordenado |
instructions | Instrucciones de la pregunta | Solicita un juicio concreto |
criteria para noul | Descripciones opcionales de true / false | Define ambas interpretaciones si la redacción es ambigua |
criteria para choice | 1–255 opciones con nombre y descripción | Delimita las categorías |
criteria para score | 2–10 descripciones de niveles ordenados | Organiza la escala de menor a mayor |
Una respuesta noul es la probabilidad de sí entre 0–1. choice devuelve choice, confidence y probabilities por opción. score devuelve un score ponderado por probabilidad, confidence, una legend que asocia niveles con texto y probabilities por nivel; los puntajes fraccionarios son esperables, así que interprétalos según tu escala y no como etiquetas de categoría.
Mejora los criterios de decisión
La evidencia y los criterios explícitos ayudan a definir reglas útiles de enrutamiento:
- Incluye en state todos los hechos necesarios para el juicio; no tiene acceso a la respuesta de otra pregunta.
- Describe los límites de cada categoría y los niveles de puntuación con palabras concretas, no con etiquetas sin explicar.
- Formula preguntas separadas para factores distintos, como intención de reembolso y urgencia, y combínalos en el código.
- Contrasta una muestra etiquetada con las probabilidades y la confianza devueltas; define los umbrales de revisión a partir de esas diferencias.
Una confianza baja indica incertidumbre: escala el caso a una persona o a un modelo generativo. noul no tiene un campo de confianza independiente.
Qué mostraron nuestros ejemplos
Nuestras llamadas tardaron unos 0,6 s; una medición previa de 3 preguntas registró 0,62 s con 425 tokens de entrada. TypeSafe indica una latencia total de 70–500 ms en su anuncio de lanzamiento; esa declaración del editor es distinta de nuestras observaciones.
| Ejemplo | Resultados seleccionados | Tokens de entrada |
|---|---|---|
| Revisión de video corto | hook: problem, confidence 1,0; proof: 1,44, confidence 0,28; has_offer: 0,98 | 537 |
| Clasificación de soporte | team: billing, confidence 1,0; urgency: 1,6, confidence 0,4; refund_requested: 0,96 | 422 |
| Verificación de reseña | sentiment: 1,45, confidence 0,32; issue: quality, confidence 1,0; would_return: 0,97 | 435 |
Una categoría con alta confianza puede coexistir con un puntaje incierto; estos ejemplos no demuestran precisión sobre tu conjunto de datos.
Precio y consumo
La facturación usa los tokens de entrada medidos; los de salida no tienen costo. Consulta el precio mostrado y registra inputTokens. La reserva al aceptar la solicitud se basa en el límite de 64k tokens; la diferencia se libera al liquidarse la tarea.
Límites y solución de problemas
Este endpoint admite hasta 64 preguntas, 64k tokens por solicitud completa y 32k tokens para state más cualquier pregunta individual. Acorta state o criteria si superas el contexto; reducir preguntas podría dejar alguna todavía por encima de su límite.
Aquí se admiten texto y JSON; no están disponibles los archivos de imagen, video o audio ni las preguntas box. Representa un clip mediante una transcripción, texto en pantalla o descripciones de fotogramas. Si se rechaza una solicitud, comprueba el tipo de pregunta, la estructura de criteria, el número de opciones y ambos límites de contexto antes de reenviarla. Ante juicios incorrectos, revisa la evidencia y los criterios.
Elige Jev o una alternativa
Elige Jev para juicios tipados y un modelo generativo para prosa.
| Opción | Cuándo corresponde |
|---|---|
| Jev 1.14 | Probabilidades, categorías y puntajes según una escala |
| Jev 1.13 | Versión anterior; sin comparación medida entre versiones aquí |
| Modelo generativo | Explicación o respuesta escrita |
| Revisión humana | Evidencia ambigua o juicios inciertos |
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "typesafe/jev-1.14/decision",
"input": {
"state": "example",
"questions": {
"example": {
"type": "noul",
"instructions": "The customer asks for a refund after being billed twice."
}
}
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
