Nota do autor: em 22 de outubro de 2026, o Google descontinuou os três modelos da série Veo 3.1 Preview. Este artigo reúne a lista de modelos descontinuados, como identificar os erros, o andamento da integração com o Omni e um plano de migração para o período de transição.
Se suas tarefas de geração de vídeos começaram a falhar em massa e retornam fail_to_fetch_task, é bem provável que o Veo 3.1 Preview tenha sido descontinuado. Em 22 de outubro de 2026, o Google deixou de oferecer os três modelos da série Veo 3.1 Preview. A APIYI também desativou os canais correspondentes.
O problema não está no seu código nem é uma falha temporária da plataforma. O aviso oficial de descontinuação do Google confirmou que esses modelos foram retirados de forma definitiva. Neste artigo, você vai ver quais modelos foram afetados, como identificar rapidamente a causa do erro e como fazer uma transição tranquila antes da chegada dos modelos substitutos oficiais.
O que você vai encontrar: em 3 minutos, entenda os principais pontos sobre a descontinuação do Veo 3.1 Preview e confira uma lista de migração pronta para colocar em prática.
Resumo das principais informações sobre a descontinuação do Veo 3.1 Preview
Vamos direto ao ponto. A tabela abaixo reúne as principais informações sobre a descontinuação do Veo 3.1 Preview, com base nos anúncios oficiais do Google e nas notificações de serviço da APIYI.
| Item | Detalhes |
|---|---|
| Data de descontinuação | 22 de outubro de 2026 (data em que o Google deixará de oferecer o serviço) |
| Anunciado por | Google (aviso de descontinuação da Gemini API) |
| Modelos descontinuados | veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview |
| Modelo substituto recomendado oficialmente | gemini-omni-1.1-flash |
| Situação do canal da APIYI | O canal correspondente ao Veo 3.1 Preview foi desativado |
| Andamento da integração do Omni | Ainda está no plano de integração, com lançamento previsto para novembro. A data exata será divulgada em um comunicado |
| Erro comum | A tarefa retorna fail_to_fetch_task, e o erro 404 interno contém is no longer available |
Sobre os três modelos Veo 3.1 Preview descontinuados
Ao todo, três modelos foram descontinuados, cobrindo praticamente todas as variantes do Veo 3.1 Preview. O veo-3.1-generate-preview é a versão padrão, o veo-3.1-fast-generate-preview prioriza a velocidade e o veo-3.1-lite-generate-preview é a versão leve. Como os três pertencem à mesma geração de modelos Preview, foram descontinuados ao mesmo tempo.
Os modelos Preview são versões de teste disponibilizadas oficialmente, principalmente para coletar feedback e validar recursos. Em geral, seu ciclo de vida é mais curto que o das versões estáveis. O Google divulga o plano de descontinuação com antecedência na página oficial de avisos; quando chega a data, o acesso ao modelo é encerrado. Depois da descontinuação, não será mais possível gerar vídeos normalmente por nenhum canal se as solicitações ainda apontarem para um desses três nomes de modelo.
| Nome do modelo | Finalidade | Situação atual | Substituto oficial |
|---|---|---|---|
veo-3.1-generate-preview |
Geração de vídeos — versão padrão | Descontinuado | gemini-omni-1.1-flash |
veo-3.1-fast-generate-preview |
Geração de vídeos — versão rápida | Descontinuado | gemini-omni-1.1-flash |
veo-3.1-lite-generate-preview |
Geração de vídeos — versão leve | Descontinuado | gemini-omni-1.1-flash |
📌 Recomendação oficial: a lista de modelos descontinuados e os substitutos recomendados serão atualizados na página «Lista de modelos descontinuados» do centro de documentação da APIYI. Salve o endereço docs.apiyi.com nos favoritos e consulte-o regularmente para se preparar para a migração com antecedência.
Como identificar erros causados pela descontinuação do Veo 3.1 Preview
A primeira reação de muitos desenvolvedores é verificar o próprio código, a chave API ou a rede. Mas esse tipo de falha tem características bem claras. Compare-as com os exemplos abaixo para identificar rapidamente o problema.
Características dos erros do Veo 3.1 Preview
Se a consulta de uma tarefa de vídeo retornar fail_to_fetch_task e os detalhes do erro incluírem um 404 interno com is no longer available, você pode confirmar que a falha foi causada pela descontinuação do modelo. Isso é diferente de erros de parâmetros, falta de saldo ou bloqueios na moderação de conteúdo: nenhuma quantidade de tentativas vai resolver o problema.
| Comportamento do erro | Causa provável | Como resolver |
|---|---|---|
fail_to_fetch_task + 404 interno com is no longer available |
O Veo 3.1 Preview foi descontinuado | Troque de modelo e siga o plano de migração |
| Erro de validação de parâmetros | Os parâmetros da solicitação não atendem aos requisitos do modelo | Consulte a documentação e corrija os parâmetros |
| Erro de autenticação | A chave API é inválida ou não tem as permissões necessárias | Verifique a configuração da chave |
| Erro de saldo ou cota | O saldo da conta é insuficiente | Adicione créditos e tente novamente |
Guarde as informações do erro do Veo 3.1 Preview antes de investigar
Um ponto importante: informações de erros como fail_to_fetch_task geralmente são retornadas no corpo da resposta uma única vez. Se o seu programa registrar apenas o código de status, sem salvar o corpo completo da resposta, será difícil descobrir depois o que causou a falha. O centro de documentação da APIYI tem um guia específico sobre como preservar mensagens de erro de interfaces. Recomendamos salvar a resposta de erro completa nos logs.
O exemplo de código abaixo mostra como identificar um erro de descontinuação durante a consulta da tarefa e salvar a resposta original nos logs:
import json
import logging
# 统一接口地址：使用 APIYI OpenAI 兼容接口
BASE_URL = "https://api.apiyi.com/v1"
DEPRECATED_VEO_MODELS = {
"veo-3.1-generate-preview",
"veo-3.1-fast-generate-preview",
"veo-3.1-lite-generate-preview",
}
def check_task_result(model: str, resp_json: dict) -> str:
"""识别 Veo 3.1 Preview 下线导致的任务失败，并完整留存错误信息"""
raw = json.dumps(resp_json, ensure_ascii=False)
logging.warning("task response: %s", raw) # 错误只返回一次，务必完整留存
if "fail_to_fetch_task" in raw and "is no longer available" in raw:
if model in DEPRECATED_VEO_MODELS:
return "MODEL_DEPRECATED" # 模型已下线，需要切换模型
return "OTHER_ERROR"
Depois de identificar MODEL_DEPRECATED, o programa deve parar de tentar novamente com o modelo original e iniciar o processo de contingência ou de alerta. Caso contrário, a fila de tarefas ficará cheia de solicitações que inevitavelmente vão falhar, o que também pode atrapalhar a investigação de outros problemas.
Plano de migração após a descontinuação do Veo 3.1 Preview
O modelo oficial substituto, gemini-omni-1.1-flash, ainda não está disponível na APIYI e segue em processo de integração, com lançamento previsto para novembro. A data exata depende do anúncio oficial. Durante esse período de transição, recomendamos migrar para outro modelo de vídeo já disponível na plataforma para evitar interrupções no negócio.
| Plano de migração | Principais recursos | Disponibilidade na APIYI | Cenários indicados |
|---|---|---|---|
| gemini-omni-1.1-flash | Modelo substituto oficial do Google | Em integração, com lançamento previsto para novembro | Para quem pretende permanecer no ecossistema do Google a longo prazo |
| Seedance 2.0 | Texto para vídeo, geração com primeiro quadro ou primeiro e último quadros | Disponível | Texto para vídeo e controle pelo primeiro quadro ou pelos quadros inicial e final |
| Wan2.7 (Tongyi Wanxiang) | Texto para vídeo, imagem para vídeo e vídeo com imagem de referência | Disponível | Para quem precisa gerar vídeos a partir de imagens ou usar imagens de referência como guia |
| Modelos disponíveis na plataforma | — | Interface unificada da APIYI apiyi.com | Alterne entre vários modelos com uma única chave API |
Análise comparativa de alternativas para migração do Veo 3.1 Preview
Análise comparativa do Seedance 2.0: o Seedance 2.0 oferece geração de vídeo a partir de texto e geração com base no primeiro quadro ou nos quadros inicial e final. Se você usava o Veo 3.1 Preview para gerar vídeos a partir de texto ou com base no primeiro quadro, a migração tende a ser tranquila. Como é um modelo de terceiros, o estilo dos comandos e as características dos resultados diferem um pouco do Veo. Por isso, é melhor fazer uma rodada de testes comparativos com materiais reais antes de colocar a solução em produção.
Análise comparativa do Wan2.7: o Wan2.7 oferece geração de vídeo a partir de texto, de imagens e de imagens de referência, dando mais opções para casos de uso como manter a consistência do sujeito com base em uma imagem de referência. Se o seu negócio depende mais de imagens de entrada para orientar o resultado visual, o Wan2.7 pode ser uma opção de transição mais adequada. Como o conjunto de parâmetros é diferente do Veo, será necessário adaptar a estrutura da solicitação separadamente.
Análise comparativa do Omni: gemini-omni-1.1-flash é o modelo substituto indicado oficialmente pelo Google e, no longo prazo, é o que mais se aproxima da forma de uso do Veo. No entanto, ele ainda não está disponível na APIYI. Por isso, não é uma opção adequada para produção neste momento; recomendamos planejar a migração após o anúncio oficial.
🎯 Recomendação de migração: durante a transição, recomendamos testar o Seedance 2.0 e o Wan2.7 em paralelo pela APIYI apiyi.com, comparando os resultados com o mesmo conjunto de comandos e imagens de referência antes de escolher o modelo principal. A mesma chave API permite invocar vários modelos de vídeo, então o custo de troca é baixo.
O que precisa ser alterado na migração do Veo 3.1 Preview
Migrar não é só trocar o nome do modelo. Cada modelo de vídeo tem parâmetros e fluxos de trabalho diferentes. Recomendamos conferir os itens abaixo um por um:
- Nome do modelo: substitua todos os três nomes de modelos Veo 3.1 Preview no código e nas configurações, incluindo variáveis de ambiente, configurações do banco de dados e opções dos menus suspensos no front-end.
- Parâmetros da solicitação: confira na documentação do modelo de destino os nomes e os valores aceitos para campos como duração, resolução, proporção, primeiro quadro, primeiro e último quadros e imagens de referência.
- Lógica de consulta das tarefas: os campos de status e resultado das tarefas assíncronas podem ser diferentes. Revise a lógica de polling e a análise dos dados recebidos nos callbacks.
- Tratamento de erros: mantenha a lógica de identificação de descontinuação apresentada anteriormente e acrescente o tratamento dos códigos de erro correspondentes ao novo modelo.
- Validação dos resultados: compare as saídas dos modelos antigo e novo usando um conjunto fixo de testes. Confirme se o estilo, a nitidez e a estabilidade atendem aos requisitos do negócio.
Para facilitar a troca quando outro modelo for descontinuado, recomendamos configurar a seleção do modelo em vez de deixá-la fixa no código da aplicação:
# Configuração do roteamento de modelos de vídeo: se um modelo for descontinuado, basta alterar a configuração, sem mexer no código da aplicação
BASE_URL = "https://api.apiyi.com/v1" # Interface unificada da APIYI
VIDEO_MODEL_ROUTES = {
"text_to_video": "seedance-2.0", # Principal opção durante a transição; consulte a documentação da APIYI para confirmar o nome do modelo
"image_to_video": "wan2.7", # Para cenários de imagem para vídeo e de imagem de referência; consulte a documentação para confirmar o nome do modelo
# "default": "gemini-omni-1.1-flash", # Ative o Omni quando estiver disponível na APIYI
}
def pick_model(task_type: str) -> str:
return VIDEO_MODEL_ROUTES.get(task_type, VIDEO_MODEL_ROUTES["text_to_video"])
Os nomes de modelo no código são apenas exemplos. Para fazer chamadas, consulte os identificadores de modelo e os parâmetros publicados no centro de documentação da APIYI.
Análise do impacto do encerramento do Veo 3.1 Preview
Impactos para desenvolvedores
- Tarefas existentes falharão imediatamente: todas as solicitações que ainda usam esses 3 nomes de modelo vão falhar. É preciso substituí-los agora; tentar novamente não vai resolver.
- O canal VEO 3.1 Official também será afetado: esse canal encaminha as solicitações diretamente para o endpoint oficial do Google. Com o encerramento da série Preview, os modelos correspondentes também deixarão de funcionar. Para saber quais canais VEO existentes continuam disponíveis, consulte o documento «Comparativo de seleção: VEO 3.1 Official vs. proxy não oficial» no centro de documentação.
- Será necessário adaptar os novos parâmetros: ao migrar para Seedance 2.0 ou Wan2.7, será preciso adaptar novamente a estrutura das solicitações e a lógica de consulta das tarefas. Recomendamos reservar um tempo para testes.
- É preciso aprimorar os padrões de registro de logs: este incidente mostrou que muitos projetos não salvam as respostas de erro por completo. Aproveite a oportunidade para melhorar os logs e reduzir significativamente o tempo de diagnóstico no futuro.
Impactos para o setor
- Modelos Preview não são adequados para sustentar operações essenciais: versões de prévia têm um ciclo de vida curto. Em produção, é importante ter um modelo alternativo pronto ou priorizar versões estáveis.
- Arquiteturas com vários modelos são ainda mais importantes: mudanças nos modelos de um único fornecedor podem afetar diretamente as operações. Usar uma plataforma agregadora para manter vários modelos de vídeo disponíveis para troca é uma opção mais segura.
- Os modelos de vídeo continuam evoluindo: a transição do Veo 3.1 Preview para o Omni mostra que o Google está ajustando sua linha de produtos de geração de vídeo. Novas mudanças de versão ainda podem acontecer, então vale a pena acompanhar as novidades.
Perguntas frequentes
Q1: O que significa o encerramento do Veo 3.1 Preview?
Em 22 de outubro de 2026, o Google deixou de oferecer estes três modelos: `veo-3.1-generate-preview`, `veo-3.1-fast-generate-preview` e `veo-3.1-lite-generate-preview`. Após o encerramento, não será mais possível gerar vídeos com esses nomes de modelo, e todos os canais de invocação serão afetados.
Q2: A tarefa retorna fail_to_fetch_task. O problema está no meu código?
Se o erro 404 interno incluir `is no longer available` e a solicitação for para um dos três modelos mencionados acima, o problema não está no código: a falha ocorreu porque o modelo foi descontinuado. Nesse caso, tentar novamente não vai resolver; é preciso trocar de modelo. Recomendamos salvar o corpo completo da resposta antes de investigar, pois essa mensagem de erro é retornada apenas uma vez.
Q3: Quando o modelo oficial substituto, gemini-omni-1.1-flash, estará disponível na APIYI?
A APIYI ainda não lançou o Omni; ele continua no plano de integração, com previsão de lançamento para novembro. A data exata será divulgada nos anúncios da plataforma. Quando estiver disponível, a central de documentação também será atualizada. Fique de olho nos avisos de serviço em apiyi.com.
Q4: Qual modelo de vídeo é a opção mais segura durante a transição?
Depende do seu caso de uso:
– **Texto para vídeo, controle do primeiro quadro ou dos quadros inicial e final**: considere primeiro o Seedance 2.0
– **Imagem para vídeo, com consistência do assunto baseada na imagem de referência**: considere primeiro o Wan2.7
– **Se quiser continuar no ecossistema do Google no longo prazo**: use os dois modelos acima durante a transição e migre para o Omni quando ele for lançado
Q5: Como posso testar rapidamente o desempenho dos modelos substitutos?
Recomendamos usar uma plataforma agregadora de APIs com suporte a vários modelos para fazer testes comparativos:
1. Acesse apiyi.com, da APIYI, e crie uma conta
2. Obtenha uma chave API. Novos usuários podem receber créditos gratuitos para testes
3. Defina `base_url` como `https://api.apiyi.com/v1` e, seguindo a documentação, faça chamadas ao Seedance 2.0 e ao Wan2.7 para comparar os resultados
Com a mesma chave API, você pode chamar vários modelos de vídeo e comparar os resultados usando o mesmo conjunto de materiais.
Q6: Como posso saber com antecedência se um modelo será descontinuado?
Acompanhe dois canais: a página oficial de descontinuação da Gemini API do Google e a seção “Lista de modelos descontinuados” da central de documentação da APIYI. A segunda reúne os modelos descontinuados e as alternativas recomendadas, poupando o trabalho de consultar os anúncios oficiais um por um. Em projetos de produção, o ideal é verificar essas informações uma vez por mês e manter a opção de configurar o modelo no código.
Principais pontos sobre o encerramento do Veo 3.1 Preview
- Descontinuação: o Google desativou os três modelos da série Veo 3.1 Preview em 22 de outubro de 2026.
- Como identificar o erro:
fail_to_fetch_taske um 404 interno comis no longer availableindicam que o modelo foi descontinuado. - Substituto oficial: o modelo substituto é
gemini-omni-1.1-flash, com integração prevista pela APIYI para novembro. - Alternativas temporárias: use o Seedance 2.0 para geração de texto para vídeo e cenas com primeiro e último quadro; escolha o Wan2.7 para geração de imagem para vídeo e casos que envolvam imagens de referência.
- Boas práticas de diagnóstico: a mensagem de erro só é retornada uma vez, então salve o corpo completo da resposta nos logs.
- Como começar: com uma única chave API da APIYI, em apiyi.com, você pode testar e comparar vários modelos de vídeo.
Resumo
Principais pontos sobre o encerramento do Veo 3.1 Preview:
- Os três modelos foram desativados: as versões padrão, rápida e leve foram descontinuadas, e o canal correspondente da APIYI também foi desativado.
- É fácil identificar o erro: se aparecer
fail_to_fetch_taskjunto comis no longer available, inicie o processo de migração. Não é necessário ficar investigando o código repetidamente. - Há alternativas durante a transição: até o lançamento do Omni, o Seedance 2.0 e o Wan2.7 atendem à maioria dos casos de geração de vídeo.
Recomendamos substituir quanto antes os nomes dos modelos antigos no código, configurar a seleção de modelos como uma opção e aprimorar os logs de erro para facilitar a migração futura para o Omni. Você pode testar rapidamente as alternativas pela APIYI, em apiyi.com. A plataforma oferece uma interface compatível com a OpenAI e créditos gratuitos para novos usuários. Quando o Omni for lançado, também será possível mudar para ele sem complicações, usando a mesma interface.
📚 Referências
- Aviso de descontinuação da API Google Gemini: comunicado oficial sobre a descontinuação da série Veo 3.1 Preview
- Link:
ai.google.dev/gemini-api/docs/deprecations -
Saiba mais: consulte a lista de modelos descontinuados, as datas de encerramento e os modelos substitutos recomendados oficialmente.
-
Central de documentação da APIYI: lista de modelos descontinuados, guia para guardar mensagens de erro das interfaces e documentação de invocação de modelos de vídeo
- Link:
docs.apiyi.com - Saiba mais: acompanhe as atualizações sobre modelos descontinuados e alternativas recomendadas, além das informações sobre parâmetros do Seedance 2.0 e do Wan2.7.
Autor: equipe técnica da APIYI
Contato técnico: se tiver dúvidas durante a migração, entre em contato conosco pela página inicial do site da APIYI, em apiyi.com. Para consultar outros materiais, acesse a central de documentação em docs.apiyi.com.
