Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Ciclo de vida do modelo

Aula 12 de 14 Atualizada a 29 de julho de 2026 Avancado
Nesta página
  1. Antecipar alterações no modelo
  2. Os três estados de um modelo
  3. Endpoints e o seu estado
  4. Isolar a referência ao modelo
  5. Processo de migração
  6. Pontos-chave

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.

1

Ativo

O modelo está disponível e recomendado para uso em produção. Recebe otimizações e correções.

2

Descontinuado

O modelo continua a funcionar, mas será removido. Planeie a sua migração para o sucessor assim que isto for anunciado.

3

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.

EndpointEstado
/v1/responsesendpoint principal, recomendado para todos os novos projetos
/v1/chat/completionslegado, mantido para compatibilidade
/v1/images/generationsativo, geração de imagens
/v1/tokenize-textativo, 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:

  1. Atualizar o campo model na sua configuração
  2. Testar os seus prompts existentes com o novo modelo num ambiente de staging
  3. Ajustar se necessário: os modelos mais recentes podem responder de forma diferente, com variações no tom, comprimento ou formato
  4. 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