Avaliar Decisões

Envie state e questions nomeadas para um modelo de decisão. Use GET /v1/models?category=decision para verificar a disponibilidade atual e GET /v1/models/{model} para o seu contrato publicado.

O state e as instructions de cada pergunta aceitam uma string, um objeto JSON ou um array JSON. O endpoint retorna JSON de forma síncrona.

A resposta preserva os nomes das suas perguntas em answers. usage.input_tokens e usage.output_tokens relatam o uso observado quando disponível. A precificação é baseada na tarifa atual do modelo; saída gratuita não implica em zero tokens de saída.

Mensagens de chat, ferramentas, streaming e Batch não fazem parte do contrato deste 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"]
      }
    }
  }'

A requisição HTTP também pode ser utilizada com clientes fetch ou requests padrão. Uma resposta de decisão é um dado estruturado, não uma explicação em texto gerada.

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  }}