Guias de modelos e modalidades21 de outubro de 2026Flatkey Team

API do Claude Sonnet (2026): IDs de modelo, configuração, limites e código para o Sonnet 5.5

Tudo para chamar o Claude Sonnet 5.5 via API: IDs de modelo, chaves, código funcional, effort e raciocínio, limites de taxa, custos e correções de migração.

API do Claude Sonnet (2026): IDs de modelo, configuração, limites e código para o Sonnet 5.5

Para usar a API do Claude Sonnet, crie uma chave de API da Anthropic e envie uma requisição para https://api.anthropic.com/v1/messages com o ID de modelo claude-sonnet-5-5, o modelo Sonnet atual, lançado em 28 de setembro de 2026. Ele tem janela de contexto de 1M de tokens, saída máxima de 128K, raciocínio adaptativo ativado por padrão e custa US$ 2 por milhão de tokens de entrada e US$ 10 por milhão de tokens de saída, segundo os preços oficiais da Anthropic em 21 de outubro de 2026. Se você está migrando código do Sonnet 4.6 ou anterior, cinco parâmetros que funcionavam antes agora retornam erro 400; eles estão listados abaixo.

Este guia é para desenvolvedores que constroem produtos sobre o Claude: qual ID de modelo Sonnet chamar, como obter uma chave, código funcional em curl, Python e Node.js, limites de taxa por nível e as mudanças incompatíveis que mais atrapalham migrações. Para um detalhamento completo de custos de todos os modelos Claude, veja nosso guia de preços da API do Claude.

Modelos Claude Sonnet disponíveis na API

Modelo	ID do modelo na API	Status (21 out 2026)	Contexto / saída máx.	Entrada / saída por 1M tokens	Leitura de cache
Claude Sonnet 5.5	`claude-sonnet-5-5`	Atual, lançado em 28 set 2026	1M / 128K	$2 / $10	$0.10
Claude Sonnet 5	`claude-sonnet-5`	Legado	ver documentação	$2 / $10	$0.20
Claude Sonnet 4.6	`claude-sonnet-4-6`	Legado	ver documentação	$3 / $15	$0.30
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	Descontinuado, desativado em 30 nov 2026	ver documentação	$3 / $15	$0.30

Preços da página de preços da Anthropic; status dos modelos da visão geral de modelos e da página de descontinuações; especificações do Sonnet 5.5 da visão geral do Sonnet 5.5, tudo verificado em 21 de outubro de 2026.

Qual usar: use claude-sonnet-5-5 em projetos novos. Ele custa o mesmo por token que o Sonnet 5, mas metade nas leituras de cache (US$ 0,10 contra US$ 0,20 por milhão), segundo o guia de migração. Em relação ao Sonnet 4.6 (US$ 3 / 15), o Sonnet 5.5 é mais barato por token, mas atenção ao tokenizador: a Anthropic informa que o Sonnet 5.5 gera cerca de 30% mais tokens que o Sonnet 4.6 para o mesmo texto, então compare contagens reais, não só o preço de tabela. Quem usa o Sonnet 4.5 precisa migrar antes da desativação em 30 de novembro de 2026.

Sonnet 5.5 em resumo

Especificação	Valor	Fonte
ID do modelo (Claude API, Google Cloud, Microsoft Foundry, Claude Platform on AWS)	`claude-sonnet-5-5`	Visão geral
ID do modelo no Amazon Bedrock	`anthropic.claude-sonnet-5-5`	Visão geral
Janela de contexto	1M de tokens	Visão geral
Saída máxima	128K tokens; 300K na Batch API com o cabeçalho beta `output-300k-2026-03-24`	Visão geral
Modalidades	Texto e imagens na entrada, texto na saída	Visão geral
Raciocínio	Adaptativo, ativado por padrão; o nível mínimo é `between_tools`	Visão geral
Effort padrão	`high`	Visão geral
Corte de conhecimento	Junho de 2026	Visão geral
Desativação	Não antes de 28 de setembro de 2027	Visão geral

Como obter uma chave de API do Claude Sonnet

Entre no Claude Console e abra API keys.
Crie uma chave, copie-a uma única vez e guarde-a como ANTHROPIC_API_KEY no seu ambiente ou gerenciador de segredos.
Adicione créditos ou um meio de pagamento. O nível de uso (e os limites de taxa) sobe conforme o gasto; veja a seção de limites abaixo.

Uma chave serve para todos os modelos Claude, então não existe uma "chave de API do Sonnet" separada. Se você prefere uma única chave para Claude, GPT, Gemini e DeepSeek, uma API unificada como a Flatkey emite uma chave para todos eles (detalhes no final).

Sua primeira requisição ao Claude Sonnet 5.5

A requisição abaixo segue o exemplo oficial da Anthropic no guia de migração do Sonnet 5.5. Ela define um nível de effort e evita todos os parâmetros que retornam 400 neste modelo.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    "output_config": {"effort": "medium"}
  }'

Python, com o SDK oficial anthropic:

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    output_config={"effort": "medium"},
)

print("stop_reason:", response.stop_reason)
for block in response.content:
    if block.type == "text":  # adaptive thinking may add thinking blocks first
        print(block.text)

Node.js com @anthropic-ai/sdk:

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
  output_config: { effort: "medium" },
});

const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);

Leia a resposta pelo tipo de bloco. Com o raciocínio adaptativo ativado, o primeiro bloco de conteúdo pode ser um bloco thinking, então response.content[0].text não é seguro no Sonnet 5.5.

Effort e raciocínio no Sonnet 5.5

O Sonnet 5.5 substitui orçamentos fixos de raciocínio por um ajuste effort dentro de output_config (documentação de effort). O padrão é high. O guia de migração da Anthropic mostra os níveis low, medium, high, xhigh e max.

Você quer	Envie	Observações da documentação da Anthropic
Comportamento padrão	nada, ou `thinking: {"type": "adaptive"}`	O raciocínio adaptativo vem ativado por padrão
Respostas mais baratas e rápidas	`output_config: {"effort": "low"}` ou `"medium"`	Menos effort significa menos tokens de saída
Sem raciocínio prévio	`thinking: {"type": "between_tools"}`	Aceito em `low`, `medium`, `high`; retorna 400 em `xhigh` ou `max`
Problemas mais difíceis	`output_config: {"effort": "xhigh"}` ou `"max"`	Use raciocínio adaptativo, não `between_tools`

O Sonnet 5.5 não aceita thinking: {"type": "disabled"}; between_tools é o ajuste mínimo (guia de migração).

Parâmetros que agora retornam erro 400

Se você está atualizando do Sonnet 4.6 ou anterior, remova estes parâmetros. Os cinco estão listados no guia de migração do Sonnet 5.5 da Anthropic:

Parâmetro antigo	No Sonnet 5.5	Substitua por
`thinking: {"type": "enabled", "budget_tokens": N}`	Erro 400	`output_config.effort`
`temperature`, `top_p`, `top_k`	Erro 400	Instruções no prompt; effort
Prefill do assistente (última mensagem de `assistant`)	Erro 400	Saídas estruturadas ou instruções de sistema
`tool_choice` forçado (`any` ou uma ferramenta específica)	Erro 400	`auto` com instruções claras sobre ferramentas
`thinking: {"type": "disabled"}`	Erro 400	`thinking: {"type": "between_tools"}`

Revise também max_tokens e suas estimativas de custo por causa do aumento de cerca de 30% em tokens em relação ao Sonnet 4.6. Se aparecerem erros de ID de modelo após a atualização, nossos guias sobre Claude: versão de modelo não encontrada e erros 400 da Anthropic cobrem as causas mais comuns.

Limites de taxa da API do Claude Sonnet

A Anthropic publica os limites por nível na página de limites de taxa. Para o Sonnet 5.5, em 21 de outubro de 2026:

Nível	Requisições por minuto	Tokens de entrada por minuto	Tokens de saída por minuto
Start	1.000	2.000.000	400.000
Build	5.000	5.000.000	1.000.000
Scale	10.000	10.000.000	2.000.000

Sonnet 5, Sonnet 4.x e Haiku 5.5 compartilham os mesmos números por nível. A Anthropic observa que, na maioria dos modelos, tokens de entrada lidos do cache não contam para o limite de tokens de entrada por minuto, o que faz do prompt caching uma ferramenta tanto de custo quanto de limite.

Quanto o Sonnet 5.5 custa na prática

Preços oficiais em 21 de outubro de 2026, por 1M de tokens (preços):

Item	Preço
Entrada	$2.00
Saída	$10.00
Gravação em cache, 5 minutos	$2.50
Gravação em cache, 1 hora	$4.00
Leitura de cache	$0.10
Batch API entrada / saída	$1.00 / $5.00
Inferência somente nos EUA (`inference_geo`)	1,1x em todos os preços de tokens

Exemplo prático: um assistente de suporte com 50.000 requisições por mês, cada uma com um prompt de sistema em cache de 3.000 tokens, 500 tokens de entrada novos e 400 de saída. Leituras de cache: 150M tokens × US$ 0,10 = US$ 15. Entrada nova: 25M × US$ 2 = US$ 50. Saída: 20M × US$ 10 = US$ 200. Total de cerca de US$ 265 por mês, sem contar as gravações pontuais em cache. A saída domina, por isso o effort importa mais do que otimizar a entrada. Para comparações modelo a modelo, veja preços da API do Claude e roteamento de API Claude vs GPT.

Usando o Claude Sonnet com o SDK da OpenAI

A Anthropic oferece um endpoint compatível com a OpenAI em https://api.anthropic.com/v1/, mas sua página de compatibilidade com o SDK da OpenAI o descreve como voltado a testes e comparações, não à maioria dos usos em produção: o parâmetro strict do function calling é ignorado, response_format é ignorado e não há suporte a prompt caching. Em produção com o Sonnet 5.5, use a Messages API nativa mostrada acima. Nosso artigo sobre compatibilidade da API do Claude com o SDK da OpenAI explica as opções em detalhes.

Uma chave para o Sonnet e outros modelos: Flatkey

Se o seu produto também chama GPT, Gemini ou DeepSeek, a Flatkey oferece uma chave e um saldo pré-pago para todos. Em 21 de outubro de 2026, a página do modelo Claude Sonnet 5.5 da Flatkey listava US$ 1,60 de entrada / US$ 8,00 de saída por 1M de tokens, 20% abaixo dos US$ 2 / 10 da Anthropic, e o Sonnet 4.6 a US$ 2,40 / 12,00. O SDK da Anthropic funciona trocando a base URL para https://router.flatkey.ai (sem /v1), conforme o guia do SDK da Anthropic da Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Para configurar o Claude Code, veja configuração do roteador de API no Claude Code. Use a Anthropic diretamente se precisar de recursos ou contratos disponíveis apenas na plataforma dela, como cabeçalhos beta específicos no dia do lançamento ou um contrato corporativo.

Perguntas frequentes

Qual é o nome do modelo da API do Claude Sonnet?

O ID atual é claude-sonnet-5-5 na Claude API, Google Cloud, Microsoft Foundry e Claude Platform on AWS, e anthropic.claude-sonnet-5-5 no Amazon Bedrock, em 21 de outubro de 2026. IDs mais antigos incluem claude-sonnet-5 e claude-sonnet-4-6.

Quanto custa a API do Claude Sonnet?

O Claude Sonnet 5.5 custa US$ 2 por milhão de tokens de entrada e US$ 10 por milhão de tokens de saída, com leitura de cache a US$ 0,10 e a Batch API pela metade do preço (US$ 1 / 5), segundo a página de preços da Anthropic verificada em 21 de outubro de 2026.

A API do Claude Sonnet é gratuita?

Não. A API da Anthropic é cobrada por token; não há nível gratuito de API para o Sonnet. Os apps do Claude para consumidores têm planos gratuitos e pagos próprios, separados da cobrança da API. Para opções gratuitas de outros provedores, veja nosso guia de APIs de LLM gratuitas.

Qual é a janela de contexto do Claude Sonnet 5.5?

1M de tokens, com até 128K tokens de saída por requisição, ou 300K na Message Batches API com o cabeçalho beta output-300k-2026-03-24.

Por que minha requisição ao Sonnet retorna erro 400 após a atualização?

O Sonnet 5.5 rejeita orçamentos de raciocínio, temperature/top_p/top_k, prefill do assistente, escolha forçada de ferramenta e thinking: {"type": "disabled"}. Remova-os e use output_config.effort ou thinking: {"type": "between_tools"}.

Existe uma API do Claude Sonnet 5?

Sim. O claude-sonnet-5 ainda pode ser chamado como modelo legado a US$ 2 / 10 por milhão de tokens, com leitura de cache a US$ 0,20. O Sonnet 5.5 tem o mesmo preço por token e leitura de cache pela metade, então é a melhor escolha padrão para projetos novos.