Acompanhamento de Descontinuações e Migrações
Modelos são aposentados, parâmetros são renomeados, comportamentos mudam. Esta página acompanha as mudanças incompatíveis para que as atualizações não te peguem de surpresa. Se você constrói sobre a API, dê uma olhada periodicamente.
Por que isso importa
Um ID de modelo fixado acabará sendo descontinuado e depois removido. Código que o codifica de forma rígida quebra. Um pouco de higiene evita surpresas às 2 da manhã.
Regras de sobrevivência
- Leia os IDs de modelo a partir da configuração, nunca espalhe literais pela base de código — assim a migração vira uma mudança de uma linha.
- Acompanhe os anúncios sobre datas de descontinuação e substituições recomendadas.
- Reexecute suas avaliações quando trocar de modelo — o comportamento pode mudar mesmo em um modelo "mais novo e melhor".
- Teste antes do prazo final, não depois da remoção.
Tipos comuns de mudança
| Mudança | Exemplo | O que fazer |
|---|---|---|
| Modelo aposentado | Um ID de modelo mais antigo para de funcionar | Migre para o sucessor recomendado; reavalie |
| Parâmetro substituído | Um controle de raciocínio/budget substituído por effort | Atualize as chamadas; veja Thinking e Effort |
| Mudança de padrão | Um novo modelo/comportamento padrão | Fixe intencionalmente; verifique se seus prompts ainda funcionam |
| Atualização de endpoint/SDK | Nova versão major do SDK | Leia o guia de migração; atualize deliberadamente |
Acompanhamento atual
O cronograma autoritativo fica na página oficial de descontinuação de modelos — confirme as datas lá antes de migrar. A Anthropic dá pelo menos 60 dias de aviso antes de aposentar um modelo lançado publicamente.
Modelos descontinuados
| ID do modelo | Descontinuado | Aposenta | Migre para |
|---|---|---|---|
claude-opus-4-1-20250805 (Opus 4.1) | 5 de junho de 2026 | 5 de agosto de 2026 | claude-opus-4-8 |
Requisições a um modelo após a data de aposentadoria falham — se você fixar o Opus 4.1, migre antes do prazo final.
Aposentados recentemente
claude-opus-4-20250514 (Opus 4) e claude-sonnet-4-20250514 (Sonnet 4) foram aposentados em 15 de junho de 2026. Chamadas a esses IDs agora geram erro — migre para claude-opus-4-8 e claude-sonnet-5, respectivamente.
Descontinuações de parâmetros
No Claude Opus 4.7 e versões posteriores (incluindo o Opus 4.8), os controles de amostragem temperature, top_p e top_k estão descontinuados: definir qualquer um deles com um valor diferente do padrão retorna um erro 400. Omita-os e direcione o comportamento com prompting e Thinking e Effort.
Sempre confirme seus IDs de modelo na tabela de Modelos e Preços Atuais; se você estiver em um ID mais antigo, planeje uma migração.