Referência da API

Messages (formato Anthropic)

POST/v1/messages

O formato nativo da Anthropic, atendido com a mesma chave bearer. O Claude Code e os SDKs oficiais da anthropic funcionam alterando apenas a URL base — sem adaptador, sem conversão de formato.

#Parâmetros da requisição

  • modelstringobrigatório

    ID de um modelo Claude da página de modelos, por exemplo claude-opus-5-5.

  • max_tokensintegerobrigatório

    Obrigatório no formato da Anthropic — o limite rígido de saída.

  • messagesarrayobrigatório

    Turnos no estilo Anthropic: {role: user|assistant, content}.

  • systemstringopcional

    Prompt de sistema — aqui é um campo de nível superior, não um papel de mensagem.

  • streambooleanopcional

    Transmite eventos SSE nativos da Anthropic (message_start, content_block_delta, …).

  • temperaturenumberopcional

    De 0 a 1 na escala da Anthropic.

  • toolsarrayopcional

    Definições de ferramentas da Anthropic; blocos tool_use voltam em content.

Cabeçalho anthropic-version

Envie anthropic-version: 2023-06-01, como a API oficial espera. Authorization: Bearer funciona aqui; x-api-key também é aceito para os SDKs padrão da Anthropic.

#Erros relacionados

  • 400 invalid_request_errorCorpo malformado ou parâmetro não suportado por este modelo.
  • 401Bearer token inválido ou ausente. Não há error.code neste caminho — verifique o status.
  • 402 insufficient_user_quotaO saldo da carteira não cobre a estimativa pré-reservada.
  • 429Limitação por chave. Corpo vazio; aguarde o Retry-After. Um 429 que traz insufficient_user_quota indica, na verdade, o limite de gastos diário.
  • 503 model_not_foundModelo desconhecido, ou nenhum canal saudável o atende no momento.

Tabela completa de códigos de erro →

#Exemplo de requisição

curl https://www.aisplice.store/v1/messages \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#Resposta

response.json
{
  "id": "msg_…",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [{"type": "text", "text": "Hello!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 10, "output_tokens": 5}
}

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.