Migração para o GPT-5.6: A Tabela Oficial e o Método
Nesta página
Estado em 5 de novembro de 2026. Para um novo projeto, comece pela família GPT-6 (Lição 9). No entanto, os modelos GPT-5.6 permanecem como substitutos oficiais do
gpt-5,o3eo3-pro, que serão removidos da API em 11 de dezembro de 2026. Entretanto,o4-mini,o1eo3-minijá foram desativados em 23 de outubro. O calendário completo de descontinuação consta na Lição 12.
Esta é a última lição sobre as atualizações de verão e a mais prática: o que fazer com o código construído sobre modelos anteriores? A resposta divide-se em duas partes. Primeiro, conheça os substitutos recomendados pela OpenAI, modelo por modelo. Segundo, execute uma migração metódica, pois são precisamente as migrações «óbvias» que quebram a produção.
Substitutos Oficiais
A página de descontinuações da OpenAI lista o substituto recomendado para cada modelo que foi ou está a ser desativado:
| Estava a usar | Substituto Recomendado | Remoção da API |
|---|---|---|
gpt-5 | gpt-5.6-sol | 11 de dezembro de 2026 |
gpt-5-mini | gpt-5.6-terra | 11 de dezembro de 2026 |
gpt-5-nano | gpt-5.6-luna | 11 de dezembro de 2026 |
o3 | gpt-5.6-sol | 11 de dezembro de 2026 |
o3-pro e gpt-5-pro | gpt-5.6-sol no modo pro | 11 de dezembro de 2026 |
o4-mini | gpt-5.6-terra | Já removido, 23 de outubro de 2026 |
o1 e o3-mini | gpt-5.6-sol | Já removido, 23 de outubro de 2026 |
gpt-5.1 e gpt-5.3-codex | gpt-6-sol | 1 de abril de 2027 |
gpt-5.4-nano | gpt-6-luna | 1 de abril de 2027 |
Em 5 de novembro, gpt-5.4 e gpt-5.5 não constam desta lista: continuam a ser servidos pela API, embora o GPT-5.5 tenha deixado o ChatGPT, o ChatGPT Work e o Codex em 14 de outubro. Para estes, a lógica da tabela ainda se aplica: escolha um nível de modelo e, em seguida, um esforço de raciocínio.
Encare esta tabela pelo que ela é: uma substituição recomendada, não uma garantia de comportamento idêntico. A única correspondência fiável é aquela que as suas avaliações confirmarem.
No ChatGPT
Se utiliza a interface, a migração ocorre sem a sua intervenção: o o3 deixou o ChatGPT em 26 de agosto de 2026, o GPT-5.5 em 14 de outubro, e o seletor de modelos mostra agora apenas modelos ativos. Os reflexos dos nossos cursos de integração permanecem válidos: formule com clareza, forneça contexto e itere. O que está a envelhecer são as descrições dos modelos nos seus materiais: «o3 para raciocínio» pertence ao passado. Se forma equipas, este é o ponto a atualizar primeiro.
No Seu Código: O Método de Cinco Passos
Comece por inventariar os identificadores: verifique o seu código, mas também os ficheiros de configuração e as variáveis de ambiente, onde os identificadores muitas vezes se escondem e uma pesquisa no código-fonte não os encontrará. Até o inventário estar completo, qualquer outra coisa é prematura.
Segundo passo: defina explicitamente o esforço de raciocínio. Os valores padrão mudaram: o gpt-5.4 não raciocinava se não especificasse nada, enquanto o GPT-5.6 começa em medium (Lição 4). O minimal já não existe e é substituído por low; o3-pro e gpt-5-pro são substituídos pelo modo pro. Uma migração que ignore este ponto altera a latência e os custos sem aviso prévio.
Terceiro passo, aquele que é mais frequentemente ignorado: reexecute as suas avaliações. Meça a qualidade, a latência e o custo nos seus casos de uso reais antes de mudar qualquer coisa para produção. Uma equipa que migra com base na tabela e descobre em produção que um fluxo crítico se comporta de forma diferente não poupou tempo.
Quarto passo: recalcule o orçamento. Os preços mudaram: Sol a 4 $ / 20 $ por milhão de tokens até 30 de novembro de 2026; Terra a 2 $ / 12 $; Luna a 0,20 $ / 1,20 $; e os tokens de raciocínio são faturados como tokens de saída. O cache também mudou: desde o GPT-5.6, define o tempo de vida do cache com prompt_cache_options.ttl, com padrão de 30m ou 12h, e as escritas no cache são faturadas. O guia de migração para o GPT-6 também pede para substituir o antigo parâmetro prompt_cache_retention quando se vem do GPT-5.5 ou anterior.
Finalmente, avalie a Chamada de Ferramentas Programática (Lição 5). Se os seus agentes encadeiam chamadas de ferramentas, isto pode reduzir tokens e latência, mas trata-se de um projeto de arquitetura separado da troca de identificadores. Faça primeiro a equivalência funcionar e, só depois, otimize.
A Sua Vez
Inventário num comando. Na raiz de um projeto, execute a pesquisa abaixo. Ela deteta identificadores desativados ou prestes a sê-lo, ignorando modelos atuais como gpt-5.6-sol. Para cada resultado, anote o substituto da tabela, o esforço de raciocínio a definir e o prazo limite.
grep -rnP '\b(o1|o3|o3-mini|o3-pro|o4-mini|gpt-5(-mini|-nano|-pro)?|gpt-5\.1|gpt-5\.3-codex|gpt-5\.4-nano)\b(?![.\w-])' .
Fontes Oficiais: Descontinuações · Modelos de raciocínio · Cache de prompts · Utilizar o GPT-6 (documentação da API da OpenAI) · Notas de lançamento de modelos (Centro de Ajuda da OpenAI)
Pontos-chave
- A página de descontinuações fornece um substituto oficial para cada modelo: GPT-5.6 para
gpt-5eo3, GPT-6 paragpt-5.1 o4-mini,o1eo3-minijá estão desativados;gpt-5eo3estarão em 11 de dezembro de 2026- Defina o esforço explicitamente: os valores padrão mudaram,
minimaltorna-selowe os modelos «pro» tornam-se modopro - Nenhuma mudança para produção sem reexecutar as suas avaliações e recalcular o orçamento, incluindo o cache