Texto

Evaluar decisiones

Evalúe preguntas de probabilidad, elección y puntuación con un modelo de decisión nativo.

POST
/v1/systemone

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.

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 preguntaCriteriosResultado
noulObjeto opcional con orientación tanto para true como para falsenoul, una probabilidad de 0 a 1
choiceObjeto de 1 a 255 nombres de opciones asignados a orientación o nullchoice, opcionalmente probabilities y confidence
scoreMatriz ordenada de 2 a 10 descripcionesscore de 0 al último índice; puede ser fraccionario, con legend, probabilities y confidence opcionales

La respuesta conserva los nombres de sus preguntas bajo answers. usage.input_tokens y usage.output_tokens informan sobre el uso observado cuando está disponible. El precio se basa en 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 el procesamiento por lotes (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": {"billing": "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.

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
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Encabezados

X-TokenLab-Delivery-Policy?string

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