Claude Sonnet 5.5

Use claude-sonnet-5-5 com o formato Anthropic Messages. Este documento distingue a especificação oficial das solicitações do comportamento observado nos testes de compatibilidade. Algumas opções avançadas ainda não funcionam conforme a especificação; confira as limitações antes de depender delas.

Consulte a página do modelo para ver os preços atuais de entrada, saída e cache.

Início rápido

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain how a rainbow forms in three sentences."}]
  }'

POST /v1/messages aceita autenticação por x-api-key ou Bearer e anthropic-version: 2023-06-01. Envie um cabeçalho anthropic-beta para os recursos cuja documentação oficial o exige. Mantenha as credenciais no código do servidor.

O modelo também aceita solicitações básicas de OpenAI Chat Completions (POST /v1/chat/completions) e Responses (POST /v1/responses). Use Messages para os parâmetros nativos descritos abaixo; a conversão do formato OpenAI não oferece todos os recursos da Anthropic.

Especificação oficial dos parâmetros

O Sonnet 5.5 tem uma janela de contexto de 1M tokens e um limite de saída síncrona de 128000 tokens. Os limites de saída específicos de Batch não se aplicam a este endpoint. A aplicação não define valores padrão para propriedades opcionais, salvo indicação contrária na tabela.

between_tools aceita somente sua propriedade type e os níveis de esforço low, medium ou high. Não envie display, budget_tokens ou block_binding com esse modo. Exemplo:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}

O preenchimento prévio do assistente não é compatível. Para continuar um pause_turn, reenvie sem alterações o conteúdo assistant da ferramenta do servidor retornado na resposta. A compactação resume o histórico existente e não é um preenchimento prévio do assistente. Preserve exatamente os blocos de pensamento e suas assinaturas; não os transfira entre modelos nem edite o histórico anterior sem seguir as regras oficiais de vinculação.

Na API nativa do Claude, o uso do computador exige computer_toolset_20260801; computer_20251124 é rejeitado. Configurações Advisor que usam claude-opus-4-8, claude-opus-4-7 ou claude-sonnet-5 também são rejeitadas para esse modelo executor.

Campos de solicitação de fallback

O recurso beta oficial fallbacks faz novas tentativas para recusas do classificador que atendem aos critérios. Ele não tenta novamente em casos de limites de taxa, sobrecarga ou erros do servidor, e a recusa pode persistir. Envie server-side-fallback-2026-07-01 para usar "default" ou uma lista explícita; server-side-fallback-2026-06-01 aceita somente a lista. Outras versões datadas são rejeitadas.

Uma lista explícita contém no máximo três entradas com modelos distintos, nenhum igual ao modelo solicitado. Os destinos permitidos vêm de allowed_fallback_models da beta Models API. Cada entrada permite apenas model, max_tokens, thinking, output_config e speed; os valores sobrescritos devem ser válidos para o modelo de destino. Quando esse fallback ocorre, a beta de julho converte between_tools do Sonnet 5.5 em disabled do Sonnet 5, com display omitido. Com a beta de junho, você precisa fornecer a substituição da configuração de pensamento do Sonnet 5.

fallback_credit_token serve para uma nova tentativa separada após uma recusa. Uma string seleciona o resgate estrito; um objeto acrescenta mode. No modo strict, uma falha no resgate rejeita a nova tentativa. No modo best_effort, uma falha na camada do token pode permitir que a solicitação prossiga pelo preço normal e fica registrada em usage.fallback_credit; tokens malformados e a combinação de crédito com fallbacks continuam falhando. O resgate também exige os critérios de solicitação, conta, workspace, plataforma e janela de cinco minutos descritos no guia oficial do crédito.

Uma solicitação com conteúdo inofensivo usando fallbacks: "default", o cabeçalho beta de julho e speed: "standard" retornou o texto esperado. Isso comprova somente a aceitação da solicitação: a execução do fallback e o resgate do crédito não foram verificados de ponta a ponta aqui.

Entradas de mídia e ferramentas

Imagens usam blocos image e PDFs usam blocos document em uma mensagem do usuário. Os tipos oficiais de origem incluem URLs públicas e base64 com o tipo MIME correspondente. As verificações de compatibilidade usaram um PNG em base64 e um PDF de uma página em base64, e conferiram o conteúdo das respostas. Elas não testaram todas as URLs nem todos os limites de tamanho de arquivo, resolução de imagem ou quantidade de páginas PDF.

As ferramentas do cliente usam a troca padrão tool_use → tool_result. Mantenha os IDs de uso das ferramentas inalterados e devolva o resultado em uma mensagem do usuário. Um exemplo bem-sucedido de ferramenta em modo estrito verifica os argumentos daquele exemplo, não todas as palavras-chave compatíveis de JSON Schema.

Respostas

Uma resposta sem streaming contém id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence e usage, além de campos oficiais opcionais, como container, diagnostics, context_management, stop_details e campos de resposta beta. O conteúdo pode incluir texto, pensamento, chamadas de ferramentas, resultados de ferramentas ou outros tipos de bloco oficiais; não presuma que o primeiro bloco seja texto.

No streaming, trate message_start, content_block_start, content_block_delta, content_block_stop, message_delta e message_stop. Erros também podem ocorrer dentro do fluxo. O uso pode incluir tokens comuns de entrada/saída, detalhes dos tokens de pensamento, leituras de cache e contagens separadas de criação de cache para durações de 5 minutos / 1 hora.

Uma recusa oficial do classificador é uma resposta normal com stop_reason: "refusal" e stop_details, em vez de um erro HTTP. Em uma resposta de fallback, model identifica o modelo que respondeu, os blocos de conteúdo fallback indicam as transições e usage.iterations descreve as tentativas. Confira esses campos em vez de presumir que o modelo solicitado produziu a resposta. Esses comportamentos de resposta ainda não foram verificados aqui.

Os erros de Messages usam {"type":"error","error":{"type":"...","message":"..."}}. Solicitações que falham não são cobradas.

Verificação de compatibilidade: 2026-10-01

A execução de ferramentas beta, conexões MCP reais, referências da Files API, residência geográfica dos dados, reenvio de assinaturas de pensamento, os limites completos de contexto/saída, casos-limite de mídia e o comportamento de recusa/fallback não foram validados de ponta a ponta. HTTP 200 e o nome do modelo retornado não autenticam qual modelo foi executado nem comprovam que todas as opções enviadas tiveram efeito.

Referências

• Visão geral oficial do Sonnet 5.5
• Mudanças e restrições do Sonnet 5.5
• Referência dos parâmetros de Messages
• Esforço por mensagem
• Compactação sob demanda
• Recusas e fallback
• Crédito de fallback
• Esquema OpenAPI
• Markdown para copiar