// API
Referência da API
Três endpoints cobrem 99% dos casos: chat completions (OpenAI), messages (Anthropic) e listagem de modelos.
POST /v1/chat/completions
Endpoint OpenAI-compatible. Aceita stream, temperature, max_tokens, tool calls, response_format e os demais parâmetros padrão da OpenAI.
bash
curl https://openai.claudio.legal/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4.6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Resuma a Constituicao em 1 paragrafo."}]
}'POST /v1/messages
Endpoint Anthropic-nativo. Use quando o cliente espera o formato content blocks da Anthropic - útil para Claude Code e SDK oficial Anthropic.
bash
curl https://claude.claudio.legal/v1/messages \
-H "x-api-key: sk-..." \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4.6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'GET /v1/models
Lista os modelos disponíveis para sua chave. Útil para descoberta automática em UIs.
bash
curl https://openai.claudio.legal/v1/models \ -H "Authorization: Bearer sk-..."
Parâmetros principais
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
model | string | Sim | ID do modelo (ex.: claude-sonnet-4.6). |
messages | array | Sim | Lista de mensagens com role e content. |
max_tokens | integer | Não | Máximo de tokens na resposta. Default depende do modelo. |
stream | boolean | Não | Quando true, retorna server-sent events incrementalmente. |
temperature | number | Não | Entre 0 e 2. Default 1. Valores baixos = mais determinístico. |