Texto
Evaluar decisiones
Evalúe preguntas de probabilidad, elección y puntuación con un modelo de decisión nativo.
Envíe state y questions con nombre a un modelo de decisión. Utilice GET /v1/models?category=decision para conocer la disponibilidad actual y GET /v1/models/{model} para consultar su contrato publicado.
Jev tiene dos versiones: la estable jev-1.14 (alias de solicitud jev-latest y jev-preview) y la anterior jev-1.13. Los ejemplos utilizan jev-1.13; consulta Decisiones para elegir entre ellas.
state y las instructions de cada pregunta aceptan una cadena, un objeto JSON o una matriz JSON. El endpoint devuelve JSON de forma síncrona.
| Tipo de pregunta | Criterios | Resultado |
|---|---|---|
noul | Objeto opcional con orientación para true y false | noul, una probabilidad de 0 a 1 |
choice | Objeto de 1 a 255 nombres de opciones asignados a orientación o null | choice, opcionalmente probabilities y confidence |
score | Matriz ordenada de 2 a 10 descripciones | score de 0 al último índice; puede ser fraccional, con legend, probabilities y confidence opcionales |
La respuesta conserva los nombres de sus preguntas bajo answers. usage.input_tokens y usage.output_tokens informan del uso observado cuando está disponible. El precio proviene de la tarifa actual del modelo; que la salida sea gratuita no implica que no haya tokens de salida.
Los mensajes de chat, las herramientas, el streaming y Batch no forman parte del contrato de este endpoint.
curl https://api.tokenlab.sh/v1/systemone \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev-1.13",
"state": "I was charged twice. Please refund the duplicate payment.",
"questions": {
"refund_requested": {"type": "noul", "instructions": "Is a refund requested?"},
"department": {
"type": "choice", "instructions": "Which team should handle this?",
"criteria": {"refunds": "Charges and refunds", "technical": "Software bugs"}
},
"urgency": {
"type": "score", "instructions": "Rate urgency",
"criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
}
}
}'La solicitud HTTP también se puede utilizar con clientes fetch o requests estándar. Una respuesta de decisión es un dato estructurado, no una explicación de texto generada.
Ejemplo de respuesta. Los valores son ilustrativos:
{
"model": "jev-1.13",
"answers": {
"refund_requested": { "type": "noul", "noul": 0.97 },
"department": {
"type": "choice",
"choice": "refunds",
"probabilities": { "refunds": 0.93, "technical": 0.07 },
"confidence": 0.93
},
"urgency": { "type": "score", "score": 1.2, "confidence": 0.7 }
},
"usage": { "input_tokens": 412, "output_tokens": 38 }
}Errores
La solicitud rechaza campos desconocidos y preguntas no válidas con 400 invalid_request. Un modelo que no sea de decisión devuelve 400 unsupported_endpoint. Maneje otros estados como se indica en Manejo de errores de la API.
curl -X POST "https://example.com/v1/systemone" \ -H "Content-Type: application/json" \ -d '{ "model": "string", "state": "string", "questions": { "property1": { "type": "noul", "instructions": "string" }, "property2": { "type": "noul", "instructions": "string" } } }'{ "id": "string", "model": "string", "answers": { "property1": { "type": "noul", "noul": 0 }, "property2": { "type": "noul", "noul": 0 } }, "usage": { "input_tokens": 0, "output_tokens": 0 }}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Cuerpo de la solicitud
application/json
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json