Ciclo de vida do modelo
Nesta página
Antecipar alterações no modelo
A sua aplicação em produção depende de um ID de modelo específico armazenado na sua configuração. Esse ID não é permanente: são lançadas novas versões, as antigas são descontinuadas e, posteriormente, removidas. As equipas que ignoram este calendário descobrem o problema no dia em que os seus pedidos começam a falhar em massa — mesmo que nada tenha sido alterado nas suas implementações. Compreender o ciclo de vida transforma esta interrupção numa migração planeada.
Ativo
O modelo está disponível e recomendado para uso em produção. Recebe otimizações e correções.
Descontinuado
O modelo continua a funcionar, mas será removido. Planeie a sua migração para o sucessor assim que isto for anunciado.
Obsoleto (Removido)
O modelo é removido da API. Qualquer pedido que utilize este ID falhará com um erro.
Os três estados de um modelo
Um modelo ativo está totalmente operacional e é o único estado que deve utilizar em produção. A xAI pode aplicar otimizações menores sem alterar o ID: o modelo que invoca por este nome hoje não é necessariamente idêntico, byte por byte, ao de há três meses — uma nuance que a próxima lição abordará na prática.
A transição para o estado descontinuado não provoca qualquer rutura. O modelo continua a responder normalmente, mas a xAI anuncia a sua futura remoção. Este é o sinal que esperava: a partir deste anúncio, dispõe de uma janela de tempo — geralmente várias semanas — para preparar, testar e implementar a mudança para o sucessor. Uma equipa que monitoriza os anúncios de descontinuação migra ao seu próprio ritmo; uma equipa que não o faz migra às pressas.
O estado obsoleto é o fim da linha: o modelo é retirado e qualquer pedido que contenha o seu ID falha. Não existe fallback automático para uma versão próxima, nem período de carência. Se a sua aplicação ainda referenciar este modelo nesse dia, ela deixa de funcionar.
Endpoints e o seu estado
Os endpoints seguem uma lógica semelhante, com o seu próprio estado.
| Endpoint | Estado |
|---|---|
/v1/responses | endpoint principal, recomendado para todos os novos projetos |
/v1/chat/completions | legado, mantido para compatibilidade |
/v1/images/generations | ativo, geração de imagens |
/v1/tokenize-text | ativo, contagem de tokens |
O caso do /v1/chat/completions merece uma explicação, já que a sua longevidade causa confusão. A sua compatibilidade com o formato OpenAI tornou-o o ponto de entrada natural para todas as equipas provenientes de outro fornecedor: altera o URL base e a chave, e o código existente funciona. Esta vantagem tem uma contrapartida: o endpoint deixa de receber novas funcionalidades, pois o desenvolvimento foca-se agora no /v1/responses. Pode continuar a utilizá-lo, mas todas as novas capacidades passarão ao seu lado.
Isolar a referência ao modelo
Toda a dificuldade de uma migração joga-se antes de esta acontecer, na forma como o seu código nomeia o modelo. Se este aparecer codificado diretamente em quinze ficheiros, alterar o ID torna-se numa caça ao tesouro com omissões inevitáveis. Se for declarado num único local, a migração demora um minuto:
# config.py
GROK_MODEL = "grok-4.20-0309" # Versão fixa para produção
GROK_MODEL_FAST = "grok-build-0.1"
# Facilita a migração: apenas um local a modificar
Experimente este exercício na sua própria base de código: procure todas as ocorrências literais de um nome de modelo. Se a contagem exceder um, tem dívida técnica para liquidar antes da próxima descontinuação, e não depois.
Processo de migração
Uma vez efetuada esta centralização, a mudança segue quatro passos:
- Atualizar o campo
modelna sua configuração - Testar os seus prompts existentes com o novo modelo num ambiente de staging
- Ajustar se necessário: os modelos mais recentes podem responder de forma diferente, com variações no tom, comprimento ou formato
- Implementar gradualmente: comece com uma percentagem de tráfego antes de mudar completamente
O passo 3 é o mais subestimado. Um modelo mais recente é geralmente melhor, mas «melhor» não significa «idêntico»: uma resposta mais detalhada quebra uma exibição calibrada, um formato ligeiramente diferente falha na análise JSON, um tom mais cauteloso altera a experiência do utilizador. É exatamente isto que a implementação gradual do passo 4 lhe permite detetar em tráfego real antes que todos os seus utilizadores o sofram.
Pontos-chave
- Os modelos passam por três estados: Ativo, Descontinuado e, depois, Obsoleto (removido)
- O endpoint
/v1/responsesé o principal;/v1/chat/completionsé legado e já não recebe novas funcionalidades - Centralize o nome do modelo num ficheiro de configuração para facilitar as migrações
- Teste sempre os seus prompts com o novo modelo antes de migrar para produção
- Monitore os anúncios de descontinuação para planear as suas migrações atempadamente