Três endpoints de imagem fecham a 17 de agosto — migre com provas, não com esperança

Primeiro feche o âmbito: três identificadores, um destino recomendado e nove dias

A página oficial de depreciações lista os três endpoints como lançados em junho de 2025, com encerramento a 17 de agosto de 2026 e substituição recomendada por `gemini-3.1-flash-image`. A mesma página mostra o substituto como modelo estável, lançado em maio, sem data de encerramento anunciada. As release notes registam o anúncio original em 15 de junho.

A documentação também esclarece que uma data de shutdown é a data mais cedo em que o modelo pode ser retirado e que a data exata deve ser comunicada. Não use essa formulação para adiar: planeie a migração para terminar antes do marco publicado e confirme o comportamento real na conta de produção.

O modelo de substituição não promete uma saída idêntica

Uma aplicação pode continuar a devolver HTTP 200 e, ainda assim, falhar o produto. Imagens podem mudar de proporção, detalhe, aderência ao prompt, tratamento de referências, conteúdo proibido, tempo de geração ou tamanho. Se a saída alimenta campanhas, catálogos ou publicação automática, cada diferença pode criar retrabalho ou risco externo.

Separe critérios bloqueantes de preferências. Um formato inesperado, uma falha de moderação ou um custo fora do limite bloqueia. Uma variação estilística só bloqueia quando quebra um requisito aprovado. Guarde a versão do prompt, parâmetros, seed quando aplicável, resposta técnica, ficheiro final e decisão humana.

Um rollout curto pode continuar a ser controlado

Hoje, resolva todas as referências ao modelo e congele o corpus. Amanhã, execute os dois caminhos e classifique diferenças. Depois, passe uma pequena percentagem de tráfego para o substituto com métricas separadas. Só então altere o default e retire o fallback antigo.

O rollback não é um slogan: deve indicar que versão volta, quem decide, que pedidos ficam pendentes e como reconciliar custos e ficheiros já produzidos. Quando o endpoint antigo deixar de responder, a reversão passa a ser para uma versão interna estável, uma fila segura ou uma suspensão controlada — não para o modelo encerrado.

• Não deixe identificadores de modelo espalhados por código, templates e variáveis sem um inventário único.
• Não compare exemplos escolhidos depois de ver os resultados; fixe o corpus e os critérios antes.
• Não promova apenas porque a média de latência melhorou; inspecione caudas, recusas e resultados rejeitados.
• Registe a decisão de retirar o endpoint antigo e a última prova de que deixou de ser necessário.