Nota do autor: o claude-sonnet-4-5 será descontinuado em 30/11/2026. Este artigo explica o que muda no ID do modelo, no multiplicador de leitura do cache e na cobrança ao migrar para claude-sonnet-5-5. Também traz uma lista de campos para conferir no dia da troca e um método de validação.
Se o seu código, arquivo de configuração ou roteamento do gateway ainda usa claude-sonnet-4-5 ou a versão com data claude-sonnet-4-5-20250929, é hora de planejar a migração. A página de descontinuação de modelos da Anthropic já marca essa versão como obsoleta. O anúncio foi feito em 30/09/2026, e a descontinuação está prevista para 30/11/2026. O modelo indicado oficialmente para substituí-la é claude-sonnet-5-5.
Este não é mais um artigo promocional sobre como “o novo modelo é melhor”. Aqui, vamos falar apenas das etapas de engenharia para migrar do Sonnet 4.5 para o Sonnet 5.5: como alterar o ID do modelo, o que muda nos multiplicadores e nos preços, quais campos precisam ser atualizados no dia da troca e como validar a migração depois. As diferenças de capacidade não fazem parte das conclusões deste artigo: você precisa testá-las com a regressão das suas próprias tarefas.
Principal benefício: ao terminar de ler, você terá uma tabela comparativa dos modelos antigo e novo, uma sequência prática para fazer a troca e saberá qual requisição enviar e quais campos conferir para confirmar que a migração deu certo.
Principais pontos da migração do Sonnet 4.5 para o Sonnet 5.5
Vamos direto ao ponto. A tabela abaixo resume os quatro aspectos mais importantes desta migração. Os dados são de 10/11/2026.
| Aspecto | Detalhes | Impacto para você |
|---|---|---|
| Data de descontinuação | claude-sonnet-4-5-20250929 será descontinuado em 30/11/2026. O anúncio foi feito em 30/09/2026. |
Faltam cerca de 20 dias. É preciso concluir a migração antes do fim do mês. |
| Modelo substituto oficial | A Anthropic recomenda migrar para claude-sonnet-5-5. |
O destino da migração está definido, sem necessidade de escolher entre vários modelos. |
| Os dois modelos estão disponíveis | Os modelos novo e antigo continuam na lista de modelos da plataforma. | Você pode mantê-los em paralelo por um tempo para fazer testes graduais e de regressão. |
| Mudanças nos preços e no multiplicador de cache | Os preços unitários de entrada, saída e leitura de cache foram reduzidos. O multiplicador de leitura de cache caiu de 0,1 para 0,05. | O valor da fatura vai mudar, e a diferença será mais perceptível em serviços com alta taxa de acerto de cache. |
Sonnet 4.5 e Sonnet 5.5 estão disponíveis ao mesmo tempo
Não é preciso fazer uma troca de uma só vez. Em 10/11/2026, consultamos a interface pública de preços da APIYI, em apiyi.com, e encontramos 283 modelos. claude-sonnet-4-5 e claude-sonnet-4-5-20250929 continuam disponíveis, assim como claude-sonnet-5-5 e claude-sonnet-5-5-thinking. Como os modelos novo e antigo podem ser usados ao mesmo tempo, antes da data de descontinuação você pode usar a mesma chave API e a mesma interface compatível com OpenAI para transferir o tráfego gradualmente do ID antigo para o novo.
Vale lembrar que a versão com data, claude-sonnet-4-5-20250929, e a versão sem data, claude-sonnet-4-5, costumam aparecer em diferentes partes do código. A primeira é comum em scripts de avaliação offline que precisam de resultados reproduzíveis; a segunda, no código da aplicação e no sistema centralizado de configurações. Durante a migração, procure as duas formas e não altere apenas uma delas.
A variante thinking na migração para o Sonnet 5.5
claude-sonnet-5-5-thinking aparece como um item independente na interface de preços e tem seu próprio multiplicador. Se o seu serviço já diferencia chamadas comuns de chamadas com raciocínio aprofundado, faça o mapeamento de cada uma separadamente durante a migração. Não misture o preço da variante thinking com o do modelo base claude-sonnet-5-5. A conversão de preços apresentada mais adiante neste artigo vale apenas para o modelo base. Para a variante thinking, consulte o item correspondente na lista de modelos da plataforma.
Comparação dos IDs dos modelos Sonnet 4.5 e Sonnet 5.5
O primeiro passo da migração é criar uma tabela de mapeamento de IDs. A tabela abaixo lista as formas antigas e as novas formas recomendadas:
| Forma atual | Status | Forma após a migração | Observações |
|---|---|---|---|
claude-sonnet-4-5-20250929 |
Descontinuado; aposentadoria em 2026-11-30 | claude-sonnet-5-5 |
Substituição recomendada oficialmente |
claude-sonnet-4-5 |
Ainda está listado; deve ser migrado junto com o snapshot | claude-sonnet-5-5 |
Forma mais comum no código de negócios |
| Chamadas do Sonnet 4.5 montadas manualmente para cenários de raciocínio | É preciso confirmar caso a caso | claude-sonnet-5-5-thinking |
Entrada independente, com cobrança separada |
Recomendamos centralizar o mapeamento em um único lugar, como no centro de configuração ou em variáveis de ambiente, em vez de codificar os valores diretamente em vários serviços. Assim, será preciso alterar apenas um lugar perto da data de aposentadoria, e o rollback também ficará mais fácil.
Variação de preços e倍率 de leitura do cache após a migração para Sonnet 5.5
Como interpretar a conversão dos倍率
A API de preços não informa valores em dólares, mas três campos de倍率: model_ratio (倍率 de entrada), completion_ratio (multiplicador da saída em relação à entrada) e cache_ratio (multiplicador da leitura do cache em relação à entrada). Neste artigo, usamos o mesmo critério de conversão das publicações anteriores da plataforma:
-倍率 1 = US$ 2 por milhão de tokens de entrada
– Preço unitário de saída = preço unitário de entrada × completion_ratio
– Preço unitário de leitura do cache = preço unitário de entrada × cache_ratio
Os preços em dólares da tabela abaixo foram convertidos segundo esse critério e não correspondem aos preços oficiais de tabela. Dados de 2026-11-10.
| Modelo | model_ratio | completion_ratio | cache_ratio | Entrada US$/milhão de tokens | Saída US$/milhão de tokens | Leitura do cache US$/milhão de tokens |
|---|---|---|---|---|---|---|
claude-sonnet-4-5 |
1.5 | 5 | 0.1 | $3 | $15 | $0.30 |
claude-sonnet-5-5 |
1 | 5 | 0.05 | $2 | $10 | $0.10 |
Entenda a variação no倍率 de leitura do cache do Sonnet 5.5
A tabela mostra duas mudanças. A primeira está nos倍率 básicos: model_ratio caiu de 1.5 para 1, enquanto completion_ratio permaneceu em 5. Com isso, os preços unitários de entrada e saída caíram cerca de um terço. A segunda mudança está na leitura do cache: cache_ratio caiu de 0.1 para 0.05. Somada à redução do倍率 básico, isso fez o preço unitário de leitura do cache cair de $0.30 para $0.10, uma redução de cerca de dois terços.
Isso significa que, mesmo migrando apenas o ID do modelo, o impacto na fatura varia conforme o tipo de uso. Em cenários com alta taxa de acerto no cache — como comandos de sistema longos, perguntas e respostas sobre documentos extensos e agentes com várias interações —, a leitura do cache representa uma parcela maior da fatura. Por isso, a variação geral pode ser mais significativa do que em operações que dependem apenas de entrada e saída. Ao fazer o orçamento, não use uma única porcentagem para estimar todos os casos.
Exemplo de variação na fatura (uso hipotético)
A seguir, usamos um volume mensal hipotético para mostrar como os três preços afetam a fatura em conjunto. Os valores servem apenas para demonstrar o cálculo; substitua-os pelas suas próprias estatísticas de uso.
| Item de cobrança | Uso mensal hipotético | Custo convertido no Sonnet 4.5 | Custo convertido no Sonnet 5.5 |
|---|---|---|---|
| Entrada | 10 milhões de tokens | $30 | $20 |
| Saída | 2 milhões de tokens | $30 | $20 |
| Leitura do cache | 30 milhões de tokens | $9 | $3 |
| Total | — | $69 | $43 |
Além disso, o cache de comandos geralmente é isolado por modelo. Ao mudar para um novo ID, o cache acumulado no modelo antigo não é reaproveitado automaticamente. As primeiras solicitações serão gravadas novamente no cache, então a taxa de acerto pode ficar temporariamente mais baixa no dia da migração, causando também uma pequena oscilação na fatura. Ao analisar os valores, recomendamos desconsiderar as primeiras horas após a migração antes de comparar os períodos anterior e posterior.
Antes e depois da migração, confira os倍率 atuais de claude-sonnet-5-5 e claude-sonnet-5-5-thinking na lista de modelos da APIYI, em apiyi.com. Atualize os valores conferidos na planilha interna de estimativa de custos e nos limites de alerta.
Guia rápido para migrar do Sonnet 4.5 para o Sonnet 5.5
Exemplo de solicitação mínima
Para chamar o novo modelo usando uma interface compatível com a OpenAI, basta prestar atenção a estes campos:
- Endereço da API
base_url:https://api.apiyi.com/v1 - Caminho da solicitação:
/chat/completions - Campo do modelo
model:claude-sonnet-5-5(substituaclaude-sonnet-4-5ouclaude-sonnet-4-5-20250929) - Autenticação: cabeçalho
Authorization: Bearer YOUR_API_KEY - Corpo da mensagem: mantenha
messagescomo está; não é necessário alterá-lo durante a migração
Se você usa o SDK oficial da OpenAI, normalmente basta alterar o base_url na inicialização do cliente e o parâmetro model na chamada. O restante do código da aplicação pode continuar igual.
Ver a lista completa de campos que precisam ser alterados
No dia da migração, confira cada um destes pontos:
– Inicialização do cliente: defina `base_url` como `https://api.apiyi.com/v1` e leia a chave API de uma variável de ambiente
– Modelo padrão: altere o `model` padrão no centro de configuração ou na variável de ambiente para `claude-sonnet-5-5`
– Roteamento de raciocínio: altere para `claude-sonnet-5-5-thinking` as ramificações que antes usavam raciocínio profundo; esse modelo tem cobrança separada
– Lista de fallback: se houver `claude-sonnet-4-5` configurado no fallback ou no fluxo de novas tentativas, substitua-o também para evitar falhas após a descontinuação
– Lista de permissões e acesso: inclua o novo ID nas listas de modelos permitidos do gateway e nos modelos disponíveis para os membros da equipe
– Custos e alertas: atualize a tabela de preços unitários e os limites dos alertas de orçamento de acordo com o novo multiplicador
– Logs e relatórios: nos painéis que contabilizam o uso pelo campo `model`, agrupe os IDs antigo e novo na mesma linha de negócio para evitar lacunas nos relatórios após a migração
– Scripts de avaliação offline: altere para o novo ID as tarefas de avaliação que usam o snapshot com data `claude-sonnet-4-5-20250929` e execute novamente a linha de base
Sugestão para começar: no ambiente de testes, use a mesma chave da APIYI para chamar os modelos novo e antigo. Registre as diferenças nas respostas e no uso antes de decidir a proporção da liberação gradual. Novos usuários podem começar executando os testes de regressão com a cota de testes gratuita.
Sequência recomendada de migração em cinco etapas
- Pesquise globalmente os IDs antigos: procure
claude-sonnet-4-5no repositório de código, no centro de configuração, nos scripts de CI e nas configurações do gateway. Inclua as versões com e sem data e organize os resultados em uma lista. - Confira os preços dos novos modelos: consulte a lista de modelos da plataforma para confirmar os multiplicadores atuais de
claude-sonnet-5-5e da variante thinking. Atualize as estimativas de custo e os limites dos alertas. - Faça a migração gradual de parte do tráfego: primeiro, direcione para o novo ID os negócios não essenciais ou uma pequena parte das solicitações. Mantenha o ID antigo atendendo ao restante do tráfego e monitore a taxa de erros e a qualidade das respostas.
- Valide usando a mesma solicitação: envie solicitações de validação fixas para os modelos antigo e novo e confirme se as respostas, o uso e a cobrança estão dentro do esperado (consulte a próxima seção).
- Migre todo o tráfego antes da data de desativação: conclua a migração completa antes de 2026-11-30 e remova o ID antigo do código e das configurações para evitar erros após a desativação em caminhos que tenham passado despercebidos.
Valide usando a mesma solicitação após a migração
O ponto principal da validação é usar “a mesma solicitação”: fixe o prompt do sistema, a mensagem do usuário e max_tokens, envie-os separadamente para o modelo antigo e para o novo e compare os itens a seguir.
- Campo
modelda resposta: confirme que o modelo informado na resposta éclaude-sonnet-5-5, e não outro modelo definido por um valor padrão ou por uma lógica de fallback. - Campos de uso em
usage: compareprompt_tokensecompletion_tokens. Se a resposta incluir campos relacionados ao cache, registre-os também para verificar se o cache está funcionando. - Resultado do negócio: avalie o resultado de acordo com seus próprios critérios, por exemplo, se a saída estruturada passa na validação JSON e se o formato das chamadas de ferramentas está correto. Use os testes de regressão das suas tarefas para avaliar diferenças de capacidade.
- Detalhamento da cobrança: localize a solicitação nos registros de uso do console da APIYI apiyi.com e confira se a cobrança corresponde ao cálculo com o novo multiplicador.
No dia seguinte, repita o teste com a mesma solicitação para observar também os acertos depois que o cache for reconstruído. Depois da aprovação, aumente gradualmente a proporção de tráfego direcionada ao novo modelo.
Perguntas frequentes (FAQ)
Q1: A qual modelo específico se refere a descontinuação do Sonnet 4.5?
A página de descontinuação da Anthropic lista o `claude-sonnet-4-5-20250929`, com status Deprecated, anúncio em 2026-09-30 e descontinuação em 2026-11-30. Também recomendamos migrar a versão `claude-sonnet-4-5`, sem data, usada nos sistemas, para evitar falhas nas chamadas após a descontinuação.
Q2: Quais diferenças devo observar ao migrar do Sonnet 4.5 para o Sonnet 5.5?
Do ponto de vista de engenharia, há três mudanças principais: o ID do modelo passa a ser `claude-sonnet-5-5`; os preços de entrada, saída e leitura do cache diminuem; e o multiplicador da leitura do cache passa de 0.1 para 0.05. Para saber se os recursos atendem ao seu caso de uso, faça testes de regressão com suas próprias tarefas. Este artigo não conclui que o novo modelo seja um substituto completo.
Q3: Ainda posso chamar o claude-sonnet-4-5 antes da data de descontinuação?
Em 2026-11-10, `claude-sonnet-4-5` e `claude-sonnet-4-5-20250929` ainda constavam na lista de modelos da plataforma e podiam ser chamados. Esse período é uma boa oportunidade para executar os modelos novo e antigo em paralelo e compará-los, mas não deixe a migração para o próprio dia da descontinuação.
Q4: Quais operações terão a maior mudança na fatura após a migração para o Sonnet 5.5?
As operações com alta proporção de leituras do cache terão as mudanças mais significativas. Por exemplo:
– **Atendimento ao cliente ou assistentes com comandos de sistema longos**: o cache de um mesmo comando longo é reutilizado em todas as solicitações
– **Perguntas e respostas sobre documentos longos**: o mesmo documento é consultado repetidamente
– **Tarefas de Agent com várias etapas**: grande parte do contexto é reutilizada entre as etapas
Q5: Como mudar rapidamente para claude-sonnet-5-5 pela API?
Depois de se cadastrar na APIYI e obter uma chave API, mantenha a forma de chamada compatível com OpenAI, aponte `base_url` para o endereço indicado neste artigo e altere `model` para `claude-sonnet-5-5`. Novos usuários podem usar a cota de teste gratuita para validar as solicitações de aceitação.
Q6: Como é cobrada a variante thinking?
`claude-sonnet-5-5-thinking` aparece como um item independente na interface de preços, com um multiplicador separado do modelo base. Os preços calculados neste artigo se aplicam apenas ao modelo base `claude-sonnet-5-5`. Consulte a lista de modelos da plataforma para verificar o preço atual da variante thinking; não use o preço do modelo base.
Q7: Quais são os riscos conhecidos da migração?
Há três riscos principais: IDs antigos fixos no código podem passar despercebidos e causar erros após a descontinuação; o cache precisa ser reconstruído no momento da mudança, o que pode reduzir temporariamente a taxa de acertos; e o estilo ou o formato das respostas pode mudar, exigindo testes de regressão nos sistemas dependentes de análise rígida de formato. Uma migração gradual, acompanhada de solicitações fixas para validação, pode cobrir a maior parte desses riscos.
Sonnet 4.5 para Sonnet 5.5: principais pontos
- Data de descontinuação definida:
claude-sonnet-4-5-20250929será descontinuado em 30/11/2026. A recomendação oficial é migrar paraclaude-sonnet-5-5. - Os modelos antigo e novo podem coexistir durante a migração gradual: em 10/11/2026, os dois modelos ainda constam na lista da plataforma, então é possível compará-los em paralelo.
- Os preços unitários dos três itens mudaram: considerando os multiplicadores, a entrada passou de US$ 3 para US$ 2, a saída de US$ 15 para US$ 10 e a leitura do cache de US$ 0,30 para US$ 0,10.
- A leitura do cache teve a maior redução:
cache_ratiocaiu de 0,1 para 0,05. O impacto será mais perceptível em aplicações com alto uso de cache. - O modo thinking tem preço próprio:
claude-sonnet-5-5-thinkingé um item separado e não deve ser confundido com o preço do modelo base. - Valide usando a mesma requisição: confira o campo
model, o uso informado emusagee os detalhes da cobrança. Para avaliar diferenças de capacidade, faça testes de regressão com suas próprias tarefas.
Resumo
Pontos principais para migrar do Sonnet 4.5 para o Sonnet 5.5:
- Atualize os IDs primeiro: mapeie
claude-sonnet-4-5eclaude-sonnet-4-5-20250929paraclaude-sonnet-5-5. Para a linha de raciocínio, use a variante thinking. - Depois, confira os preços: refaça a estimativa dos custos de entrada, saída e leitura do cache com base em
model_ratio,completion_ratioecache_ratio. - Por fim, valide a migração: após a mudança gradual, use a mesma requisição para conferir o modelo retornado, o uso e a cobrança. Remova os IDs antigos antes da data de descontinuação.
Faltam cerca de 20 dias para 30/11/2026. Recomendamos fazer uma busca global e mudar para o novo modelo no ambiente de testes ainda nesta semana, para ter tempo de executar os testes de regressão da aplicação. Se precisar comparar os modelos antigo e novo, use uma única chave na APIYI apiyi.com para fazer as chamadas e conferir o uso. Consulte a lista de modelos da plataforma para ver os modelos e preços atualizados.
📚 Referências
- Página da Anthropic sobre descontinuação de modelos: cronograma de descontinuação e aposentadoria dos modelos Claude
- Link:
platform.claude.com/docs/en/about-claude/model-deprecations -
Descrição: confirma o status, a data do anúncio, a data de aposentadoria e as recomendações oficiais de substituição para
claude-sonnet-4-5-20250929 -
Endpoint público de preços da APIYI: fonte dos dados de multiplicadores dos modelos
- Link:
api.apiyi.com/api/pricing - Descrição: consultado em 2026-11-10; inclui os campos
model_ratio,completion_ratioecache_ratio
Autor: equipe técnica da APIYI
Suporte técnico: se tiver algum problema durante a migração, entre em contato conosco pela página inicial do site da APIYI. Para consultar mais materiais de integração, acesse a central de documentação em docs.apiyi.com
