Referência da API

Chat Completions

Envie mensagens e receba texto, tool calls ou dados estruturados.

Nesta página

Request
Mensagens
Response
Compatibilidade por modelo

Request

POST/chat/completions

Cria uma resposta usando um modelo disponível para a chave.

cURL

curl https://code.verboo.ai/router/v1/chat/completions \
  -H "Authorization: Bearer $VERBOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_ID>",
    "messages": [{"role": "user", "content": "Explain why low latency matters for developer tools."}]
  }'

Campo	Obrigatório	Descrição
model	sim	ID retornado por GET /models.
messages	sim	Histórico ordenado de mensagens.
stream	não	Quando true, retorna eventos SSE.
temperature	não	Amostragem; suporte e faixa dependem do provider.
max_tokens / max_completion_tokens	não	Limite de saída, conforme o modelo.
tools / tool_choice	não	Funções disponíveis para o modelo.
reasoning_effort	não	Somente para modelos com reasoning.
response_format	não	JSON object ou JSON schema; pode depender do plano.

Mensagens

Role	Uso
system	Define comportamento e restrições globais.
user	Entrada do usuário; pode conter texto ou partes multimodais.
assistant	Resposta anterior ou solicitação de tool call.
tool	Resultado de uma função, associado por tool_call_id.

Response

200 · application/json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1786752000,
  "model": "model-id",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Low latency keeps feedback loops short."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 18, "completion_tokens": 10, "total_tokens": 28}
}

Leia choices[0].message.content para texto, choices[0].message.tool_calls para funções e usage para consumo medido.

Compatibilidade por modelo

Nem todo campo é universal

O router normaliza o fluxo principal, mas providers podem ignorar ou rejeitar parâmetros específicos. Use os guias e teste o modelo escolhido antes de produção.