API Messages

POST /v1/messages

Compatível com a API Anthropic Messages. O gateway encaminha de forma transparente para os modelos Claude via o canal Anthropic ou Bedrock configurado.

Corpo da requisição

Parâmetro	Tipo	Descrição
`model`*	`string`	ID do modelo a usar (ex. claude-sonnet-4-6).
`messages`*	`array`	Array de objetos de mensagem com função (user/assistant) e conteúdo.
`max_tokens`*	`integer`	Número máximo de tokens a gerar.
`system`	`string`	Prompt de sistema para definir o contexto da conversa.
`stream`	`boolean`	Se true, retorna um fluxo de eventos SSE. Padrão: false.
`temperature`	`number`	Temperatura de amostragem 0–1. Padrão: 1.
`tools`	`array`	Lista de definições de ferramentas para o uso de ferramentas.

Exemplo de requisição

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
x-api-key: YOUR_API_KEY

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 256,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

Exemplo de resposta

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "The capital of France is Paris." }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 9
  }
}

ℹ

A API Messages aceita ambos Authorization: Bearer e x-api-key para autenticação, seguindo a convenção do SDK da Anthropic.