POST /v1/messages

Autenticação

x-api-key: mg_live_...
anthropic-version: 2023-06-01
content-type: application/json

A autenticação do portador também é aceita.

Solicitar

curl https://api.model-gate.com/v1/messages \
  -H "x-api-key: mg_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a short release note."}
    ]
  }'

Resposta

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4.6",
  "content": [{"type": "text", "text": "This release improves documentation and model routing."}],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 11,
    "output_tokens": 9,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Transmissão

Adicionar "stream": true. O Model Gate encaminha eventos SSE compatíveis com o Anthropic e registra o uso final do token para liquidação.

Aliases e contabilidade

Se um alias for fornecido, ele será substituído pelo modelo canônico antes que a solicitação seja enfileirada ou enviada ao upstream. Preço, custo de uso, histórico de solicitações e restrições de modelo usam o modelo canônico.

Status	Significado	Ação
400	Solicitação inválida	Verifique o corpo da solicitação e o ID do modelo.
401	Chave inválida ou congelada	Verifique ou gire a chave de API.
429	Taxa ou limite de simultaneidade excedido	Respeito Retry-After e tente novamente com espera.
5xx	Erro temporário de upstream ou gateway	Tente novamente solicitações idempotentes com espera exponencial.