Claude API 2026-10-21 remove temperature, top_p e top_k

A Anthropic lançou uma nova versão da API do Claude, 2026-10-21, em 21 de outubro de 2026. Ela remove as configurações de amostragem temperature, top_p e top_k. Qualquer requisição que envie uma delas agora falha com erro 400. Sete SDKs oficiais e a ferramenta de linha de comando ant lançaram novas versões principais que a usam por padrão.

A versão anterior, 2023-06-01, foi a padrão por mais de três anos. O resumo diário de ferramentas para agentes da Munder Difflin descreve esta como a primeira nova versão da API da Anthropic desde então.

Como funcionam as versões da API do Claude

Toda requisição à API do Claude leva um cabeçalho anthropic-version. O valor é uma data que prende a requisição a um conjunto fixo de comportamentos. Para usar a nova versão sem um SDK, envie anthropic-version: 2026-10-21.

Dentro de uma mesma versão, a página de versionamento da Anthropic promete que os campos de entrada e saída existentes continuam como estão. A Anthropic ainda pode adicionar entradas opcionais, novos valores de saída e novos tipos de evento de streaming. Remover ou renomear um campo exige uma nova versão datada, e foi isso que aconteceu aqui.

Os SDKs escolhem a versão por você. O guia de migração diz que as requisições “usam a versão da API que era a atual quando a versão principal do seu SDK foi lançada”. Código em uma versão principal mais antiga do SDK continua enviando 2023-06-01 até que você o atualize.

O que deixa de funcionar na API Messages

Três formatos de requisição agora retornam erro 400, segundo as notas de versão da Anthropic:

• Configurações de amostragem. temperature, top_p e top_k foram removidos. Enviar qualquer um deles falha em todos os modelos.
• Documentos em turnos do assistente. Um bloco document colocado diretamente em uma mensagem assistant é rejeitado.
• Citações em turnos do usuário. Um bloco text com um array citations não vazio em uma mensagem user é rejeitado. Isso inclui um bloco desses aninhado dentro de um bloco search_result.

A Admin API também renomeia vários campos. Grupos RBAC usam role_ids em vez de roles, e papéis usam display_name em vez de name. Nas chaves de API, workspace_id passa para scope.workspace_id. Dois campos do Claude Enterprise Analytics também mudam: actor.email vira actor.email_address, e summaries vira data.

A nova versão funciona na API do Claude, no Claude Platform on AWS, no Microsoft Foundry e no Google Cloud. No Amazon Bedrock, ela cobre apenas o Claude 4.7 e modelos posteriores.

As novas versões principais dos SDKs

Estes são os primeiros lançamentos que enviam 2026-10-21, segundo as notas de versão e o guia de migração:

SDK ou ferramenta	Primeira versão com 2026-10-21
Python (anthropic)	2.0.0
TypeScript (@anthropic-ai/sdk)	1.0.0
C# (Anthropic)	13.0.0
Go (anthropic-sdk-go/v2)	2.0.0
Java (com.anthropic:anthropic-java)	3.0.0
PHP (anthropic-ai/sdk)	1.0.0
Ruby (gem anthropic)	2.0.0
CLI ant	2.0.0

Os SDKs trazem mudanças incompatíveis próprias, separadas da versão da API. O guia de migração lista as principais:

• Cabeçalho de autorização. Os SDKs e a CLI agora enviam a chave como Authorization: Bearer, não como X-Api-Key. A API aceita qualquer um dos cabeçalhos, mas um proxy ou gateway que leia X-Api-Key precisa mudar.
• Uma credencial por cliente. Passar ao mesmo tempo uma chave de API e um token de autenticação agora é um erro. Em Python, isso gera ValueError; em TypeScript, TypeError.
• Text Completions removido. A antiga interface de completions saiu dos SDKs de TypeScript, Go, Java e Ruby e da CLI. Use a API Messages.
• Caminho do módulo Go. Código em Go precisa trocar cada import para github.com/anthropics/anthropic-sdk-go/v2 e exige Go 1.25 ou mais recente.
• Comando de atualização no PHP. Um simples composer update continua na versão principal antiga. Use composer require para passar para a 1.0.0.

A licença também muda. A partir dessas versões, os SDKs e a CLI passam a usar a licença Apache 2.0 em vez da MIT. As versões anteriores continuam sob MIT, e o guia diz que isso não exige mudanças no código.

Mais tarde, em 21 de outubro, o Python SDK 2.1.0 e o TypeScript SDK 1.1.0 adicionaram aos perfis de usuário o status e as ações de aplicação de regras. É um recurso separado, que não faz parte da mudança de versão.

O que isso significa para desenvolvedores

Nada quebra até que você atualize a versão principal de um SDK ou mude o cabeçalho por conta própria. Isso dá tempo, mas as notas de versão não indicam nenhuma data de desativação para 2023-06-01. Planeje a mudança em vez de esperar por essa data.

• Procure primeiro as configurações de amostragem. Encontre cada chamada que define temperature, top_p ou top_k, inclusive em wrappers e arquivos de configuração. Cada uma vira um erro 400 depois da atualização.
• Verifique o que fica entre você e a API. Um proxy de logs, gateway ou scanner de segredos que leia X-Api-Key deixa de ver a chave quando o SDK passa a enviar Authorization: Bearer.
• Fixe a versão principal no lockfile. Um intervalo não fixado de anthropic ou @anthropic-ai/sdk pode pular para a nova versão principal na próxima instalação. Atualize de propósito, com testes.
• Revise conversas armazenadas. Se você reproduz históricos de mensagens salvos, verifique se há documentos em turnos do assistente ou citações em turnos do usuário.
• Avise quem cuida das licenças. As novas versões principais usam Apache 2.0, não MIT. Registre a mudança antes de a atualização ir para produção.