Completions de Chat
Solicitação e resposta de POST /v1/chat/completions.
Completions de Chat
Solicitação
POST https://apimaster.ai/v1/chat/completions
Cabeçalhos
| Cabeçalho | Obrigatório | Observações |
|---|---|---|
Authorization |
Sim | Bearer SUA_CHAVE_DE_API |
Content-Type |
Sim | application/json |
Corpo (campos comuns)
| Campo | Tipo | Observações |
|---|---|---|
model |
string | ex.: claude-sonnet-4-6 |
messages |
array | {role, content} |
max_tokens |
number | Máximo de tokens de conclusão |
temperature |
number | Opcional |
stream |
boolean | Streaming SSE |
Exemplo
curl -s "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer SUA_CHAVE_DE_API" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "system", "content": "Você é útil."},
{"role": "user", "content": "Diga oi em uma palavra."}
],
"max_tokens": 64
}'
Resposta sem streaming
{
"id": "chatcmpl-...",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "..." },
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 5,
"total_tokens": 15
}
}
Streaming
Com "stream": true, o corpo é text/event-stream; as linhas são data: {json} até data: [DONE].
Códigos de status
| Código | Significado |
|---|---|
| 400 | Parâmetros inválidos |
| 401 | Falha na autenticação |
| 402 / 403 | Cota ou permissão |
| 429 | Limite de taxa excedido |
| 502 / 503 | Erro do upstream — tentar novamente |