Nota del autor: Google retiró el 22 de octubre de 2026 los 3 modelos de la serie Veo 3.1 Preview. En este artículo recopilamos la lista de modelos descontinuados, cómo identificar los errores, el estado de la integración con Omni y un plan de migración para el periodo de transición.
Si tus tareas de generación de video han empezado a fallar de forma generalizada y devuelven fail_to_fetch_task, es muy probable que Veo 3.1 Preview haya dejado de estar disponible. Google dejó de ofrecer los 3 modelos de la serie Veo 3.1 Preview el 22 de octubre de 2026, y APIYI también desactivó los canales correspondientes.
El problema no está en tu código ni se trata de una interrupción temporal de la plataforma. El aviso oficial de retirada de Google confirma que los modelos han dejado de estar disponibles de forma definitiva. En este artículo explicamos qué modelos se ven afectados, cómo confirmar rápidamente la causa del error y cómo hacer una transición sin contratiempos antes de que estén disponibles los modelos oficiales de reemplazo.
Lo más importante: en 3 minutos podrás conocer todos los detalles sobre la retirada de Veo 3.1 Preview y tendrás una lista de migración lista para poner en práctica.
Información clave sobre la retirada de Veo 3.1 Preview
Primero, las conclusiones. La siguiente tabla resume la información clave sobre la retirada de Veo 3.1 Preview, según los anuncios oficiales de Google y las notificaciones del servicio de APIYI.
| Información | Detalles |
|---|---|
| Fecha de desactivación | 22 de octubre de 2026 (Google dejará de ofrecerlo oficialmente) |
| Anunciante | Google (anuncio de obsolescencia de Gemini API) |
| Modelos desactivados | veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview |
| Modelo sustituto oficial | gemini-omni-1.1-flash |
| Estado del canal de APIYI | El canal correspondiente a Veo 3.1 Preview está desactivado |
| Estado de la integración de Omni | Sigue en los planes de integración; se prevé su lanzamiento en noviembre. La fecha concreta se anunciará más adelante |
| Error habitual | La tarea devuelve fail_to_fetch_task; el error interno 404 incluye is no longer available |
Información sobre los 3 modelos de Veo 3.1 Preview desactivados
En esta ocasión se retiraron 3 modelos, que cubren prácticamente todas las variantes de Veo 3.1 Preview. veo-3.1-generate-preview es la versión estándar, veo-3.1-fast-generate-preview es la versión rápida, que prioriza la velocidad, y veo-3.1-lite-generate-preview es la versión ligera. Como los tres pertenecen a la misma generación de modelos Preview, se retiraron al mismo tiempo.
Los modelos Preview son versiones de prueba oficiales, pensadas principalmente para recopilar comentarios y validar capacidades. Por lo general, su ciclo de vida es más corto que el de las versiones estables. Google anuncia con antelación los planes de retirada en su página oficial de obsolescencias y, al llegar la fecha prevista, bloquea directamente el acceso al modelo. Una vez retirados, no se podrán generar videos con normalidad desde ningún canal si las solicitudes siguen apuntando a cualquiera de estos 3 nombres de modelo.
| Nombre del modelo | Función | Estado actual | Sustituto oficial |
|---|---|---|---|
veo-3.1-generate-preview |
Generación de video estándar | Retirado | gemini-omni-1.1-flash |
veo-3.1-fast-generate-preview |
Generación rápida de video | Retirado | gemini-omni-1.1-flash |
veo-3.1-lite-generate-preview |
Generación ligera de video | Retirado | gemini-omni-1.1-flash |
📌 Recomendación oficial: La lista de modelos retirados y los sustitutos recomendados se actualizarán en la página «Modelos obsoletos» del centro de documentación de APIYI. Te recomendamos guardar docs.apiyi.com en favoritos y consultarlo con regularidad para preparar la migración con antelación.
Cómo identificar errores provocados por la retirada de Veo 3.1 Preview
La primera reacción de muchos desarrolladores es revisar su código, sus claves o la red. Sin embargo, este tipo de fallo tiene características muy claras. Con los métodos siguientes, puedes identificarlo rápidamente.
Características de los errores de Veo 3.1 Preview
Si la consulta de una tarea de video devuelve fail_to_fetch_task y el 404 interno de los detalles del error incluye is no longer available, puedes confirmar que el fallo se debe a que el modelo se ha retirado. Esto es distinto de los errores de parámetros, la falta de cuota o los bloqueos de la moderación de contenido: no se solucionará por muchas veces que lo intentes de nuevo.
| Manifestación del error | Causa posible | Cómo solucionarlo |
|---|---|---|
fail_to_fetch_task + el 404 interno incluye is no longer available |
Veo 3.1 Preview se ha retirado | Cambia de modelo y sigue el plan de migración |
| Error de validación de parámetros | Los parámetros de la solicitud no cumplen los requisitos del modelo | Corrige los parámetros según la documentación |
| Error de autenticación | La clave API no es válida o no tiene permisos suficientes | Revisa la configuración de la clave |
| Error de saldo o cuota | Saldo insuficiente en la cuenta | Añade saldo e inténtalo de nuevo |
Guarda primero la información del error de Veo 3.1 Preview antes de investigarlo
Hay un detalle importante: este tipo de error, como fail_to_fetch_task, suele aparecer en el cuerpo de la respuesta una sola vez. Si tu programa solo registra el código de estado y no guarda el cuerpo completo de la respuesta, después será difícil reconstruir la causa del fallo. La guía «Cómo conservar la información de errores de las interfaces» del centro de documentación de APIYI trata este problema en detalle. Te recomendamos guardar la respuesta de error completa en los registros.
El siguiente ejemplo muestra cómo identificar errores de retirada durante la consulta de una tarea y guardar la respuesta original en los registros:
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"
Cuando se detecte MODEL_DEPRECATED, el programa debe dejar de reintentar con el modelo original y pasar a un proceso de degradación del servicio o de alerta. De lo contrario, la cola de tareas se llenará de solicitudes que inevitablemente fallarán y también dificultará la investigación de otros problemas.
Plan de migración tras la retirada de Veo 3.1 Preview
El modelo oficial de reemplazo, gemini-omni-1.1-flash, todavía no está disponible en APIYI y sigue en proceso de integración. Se espera que llegue en noviembre; la fecha exacta dependerá del anuncio oficial. Mientras tanto, te recomendamos cambiar a otro de los modelos de video disponibles en la plataforma para mantener el servicio en funcionamiento.
| Opción de migración | Capacidades principales | Disponibilidad en APIYI | Escenarios recomendados |
|---|---|---|---|
| gemini-omni-1.1-flash | Modelo oficial de reemplazo de Google | En proceso de integración; previsto para noviembre | Si quieres seguir en el ecosistema de Google a largo plazo |
| Seedance 2.0 | Texto a video y generación a partir del primer fotograma o del primero y el último | Disponible | Texto a video y control del primer fotograma o de los fotogramas inicial y final |
| Wan2.7 (Tongyi Wanxiang) | Texto a video, imagen a video y video a partir de una imagen de referencia | Disponible | Si necesitas generar videos a partir de imágenes o usar imágenes de referencia |
| Plataforma disponible | — | Interfaz unificada de APIYI apiyi.com | Cambia entre varios modelos con una sola clave API |
Análisis comparativo de alternativas para migrar desde Veo 3.1 Preview
Análisis comparativo de Seedance 2.0: Seedance 2.0 permite generar videos a partir de texto y crear videos desde el primer fotograma o desde el primero y el último. Si tu negocio usa Veo 3.1 Preview para generar videos a partir de texto o a partir del primer fotograma, la migración debería ser bastante sencilla. Como es un modelo de terceros, el estilo de las indicaciones y las características de los resultados no coinciden del todo con los de Veo. Antes de ponerlo en producción, conviene hacer pruebas comparativas con material real.
Análisis comparativo de Wan2.7: Wan2.7 permite generar videos a partir de texto, de imágenes y de imágenes de referencia. Ofrece más opciones para necesidades como mantener la coherencia del sujeto a partir de una imagen de referencia. Si tu negocio depende más de las imágenes de entrada para definir la escena, Wan2.7 puede ser una alternativa de transición más adecuada. Su sistema de parámetros es distinto al de Veo, así que tendrás que adaptar la estructura de las solicitudes por separado.
Análisis comparativo de Omni: gemini-omni-1.1-flash es el modelo alternativo recomendado oficialmente por Google y, a largo plazo, es el que más se ajusta a la forma habitual de trabajar con Veo. Sin embargo, todavía no está disponible en APIYI, por lo que de momento no es adecuado para producción. Te recomendamos planificar la migración cuando se anuncie oficialmente.
🎯 Recomendación para la migración: Durante la transición, prueba Seedance 2.0 y Wan2.7 a través de APIYI apiyi.com con el mismo conjunto de indicaciones e imágenes de referencia. Compara los resultados y luego decide cuál será tu modelo principal. Puedes invocar varios modelos de video con la misma clave API, así que cambiar de modelo tiene un costo bajo.
Cambios necesarios para migrar desde Veo 3.1 Preview
La migración no consiste solo en cambiar el nombre del modelo. Los parámetros y los flujos de trabajo varían entre modelos de video, así que te recomendamos revisar estos puntos uno por uno:
- Nombre del modelo: sustituye los tres nombres de modelo de Veo 3.1 Preview en el código y la configuración, incluidas las variables de entorno, la configuración de la base de datos y las opciones de los menús desplegables de la interfaz.
- Parámetros de la solicitud: consulta la documentación del modelo de destino para verificar los nombres y los valores admitidos de campos como la duración, la resolución, la relación de aspecto, el primer fotograma o el primer y el último fotograma, y las imágenes de referencia.
- Lógica de consulta de tareas: los campos de estado y de resultados pueden variar en las tareas asíncronas. Vuelve a verificar la lógica de sondeo y el análisis de las respuestas de las llamadas de retorno.
- Gestión de errores: conserva la lógica de detección de retirada mencionada antes y añade el manejo de los códigos de error correspondientes al nuevo modelo.
- Validación de resultados: compara las salidas nuevas y anteriores con un conjunto de pruebas fijo para confirmar que el estilo, la nitidez y la estabilidad cumplen los requisitos del producto.
Para poder cambiar rápidamente de modelo la próxima vez que uno deje de estar disponible, te recomendamos definir la selección del modelo como una opción de configuración, en lugar de dejarla fija en el código de negocio:
# 视频模型路由配置：模型下线时只改配置，不动业务代码
BASE_URL = "https://api.apiyi.com/v1" # APIYI 统一接口
VIDEO_MODEL_ROUTES = {
"text_to_video": "seedance-2.0", # 过渡期主力，具体模型名以 APIYI 文档为准
"image_to_video": "wan2.7", # 图生、参考图场景，具体模型名以文档为准
# "default": "gemini-omni-1.1-flash", # Omni 在 APIYI 上线后再启用
}
def pick_model(task_type: str) -> str:
return VIDEO_MODEL_ROUTES.get(task_type, VIDEO_MODEL_ROUTES["text_to_video"])
Los nombres de modelo del código son solo ejemplos. Para realizar llamadas, consulta los identificadores de modelo y las especificaciones de los parámetros publicados en el centro de documentación de APIYI.
Análisis del impacto de la retirada de Veo 3.1 Preview
Impacto para los desarrolladores
- Las tareas existentes fallarán directamente: todas las solicitudes que sigan usando estos tres nombres de modelo fallarán. Hay que sustituirlos de inmediato; volver a intentarlo no resolverá el problema.
- El canal VEO 3.1 Official también se ve afectado: este canal reenvía las solicitudes al endpoint oficial de Google, así que los modelos de la serie Preview dejarán de estar disponibles. Para saber qué modelos del canal VEO original siguen funcionando, consulta en el centro de documentación la «Comparativa para elegir entre VEO 3.1 Official y la API no oficial».
- Hay que adaptar los nuevos parámetros: al cambiar a Seedance 2.0 o Wan2.7, tendrás que adaptar tanto la estructura de las solicitudes como la lógica de consulta de tareas. Te recomendamos reservar tiempo para hacer pruebas.
- Hay que mejorar el registro de logs: este incidente ha dejado claro que muchos proyectos no guardan las respuestas de error de forma completa. Mejorar los logs ahora puede reducir considerablemente el tiempo de diagnóstico en el futuro.
Impacto en el sector
- Los modelos Preview no son adecuados para cargas de trabajo esenciales: las versiones Preview tienen ciclos de vida cortos. En producción, conviene tener preparado un modelo alternativo o dar prioridad a las versiones estables.
- La arquitectura multimodelo es cada vez más importante: los cambios en los modelos de un único proveedor repercuten directamente en el negocio. Usar una plataforma de agregación para conservar varios modelos de vídeo entre los que se pueda alternar es una opción más sólida.
- Los modelos de vídeo siguen evolucionando: el paso de Veo 3.1 Preview a Omni indica que Google está ajustando su línea de productos de generación de vídeo. Es posible que haya nuevos cambios de versión, así que conviene seguirlos de cerca.
Preguntas frecuentes (FAQ)
Q1: ¿Qué significa que Veo 3.1 Preview haya dejado de estar disponible?
Google dejó de ofrecer el 22 de octubre de 2026 estos tres modelos: `veo-3.1-generate-preview`, `veo-3.1-fast-generate-preview` y `veo-3.1-lite-generate-preview`. Desde entonces, estos nombres de modelo ya no permiten generar videos y el cambio afecta a todos los canales de invocación.
Q2: La tarea devuelve fail_to_fetch_task. ¿Hay algún problema con mi código?
Si el error 404 interno incluye `is no longer available` y la solicitud usa uno de esos tres modelos, no es un problema de código: se debe a que el modelo dejó de estar disponible. En este caso, volver a intentarlo no servirá; tendrás que cambiar de modelo. Antes de investigar, te recomendamos guardar la respuesta completa, ya que este tipo de mensaje de error solo se devuelve una vez.
Q3: ¿Cuándo estará disponible en APIYI el modelo oficial de reemplazo, gemini-omni-1.1-flash?
APIYI todavía no ha incorporado Omni; está previsto hacerlo y se espera que esté disponible en noviembre. La fecha exacta dependerá de los anuncios de la plataforma. Cuando se lance, también se actualizará el centro de documentación. Puedes consultar los avisos del servicio en apiyi.com.
Q4: ¿Qué modelo de video es la opción más segura durante el periodo de transición?
Depende de tu caso de uso:
– **Generación de video a partir de texto, control del primer fotograma o de los fotogramas inicial y final**: considera primero Seedance 2.0.
– **Generación de video a partir de imágenes y conservación de la coherencia del sujeto de la imagen de referencia**: considera primero Wan2.7.
– **Si quieres seguir usando el ecosistema de Google a largo plazo**: usa los dos modelos anteriores durante la transición y cambia a Omni cuando esté disponible.
Q5: ¿Cómo puedo probar rápidamente el rendimiento de los modelos alternativos?
Te recomendamos hacer pruebas comparativas con una plataforma de agregación de API compatible con varios modelos:
1. Visita APIYI en apiyi.com y crea una cuenta.
2. Obtén una clave API. Los nuevos usuarios pueden solicitar crédito gratuito para hacer pruebas.
3. Configura `base_url` como `https://api.apiyi.com/v1` y, siguiendo la documentación, invoca Seedance 2.0 y Wan2.7 para comparar los resultados.
Con una sola clave API puedes invocar varios modelos de video y comparar los resultados con el mismo conjunto de materiales.
Q6: ¿Cómo puedo enterarme con antelación de que un modelo dejará de estar disponible?
Puedes consultar dos fuentes: la página oficial de Google sobre la retirada de Gemini API y la sección «Lista de modelos obsoletos» del centro de documentación de APIYI. Esta última reúne los modelos que dejarán de estar disponibles y sus reemplazos recomendados, por lo que te ahorrará tiempo frente a revisar los anuncios oficiales uno por uno. En proyectos de producción, lo mejor es revisar esta información cada mes y permitir que el modelo se configure desde el código.
Puntos clave sobre la retirada de Veo 3.1 Preview
- Retirada: Google retiró el 22 de octubre de 2026 los tres modelos de la serie Veo 3.1 Preview.
- Cómo identificar el error:
fail_to_fetch_taskjunto con un 404 interno que incluyais no longer availableindica que el modelo fue retirado. - Alternativa oficial: El modelo alternativo es
gemini-omni-1.1-flash. Se prevé que APIYI lo integre en noviembre. - Opciones provisionales: Para generar videos a partir de texto y de fotogramas iniciales y finales, elige Seedance 2.0; para generación de video a partir de imágenes y escenas con imágenes de referencia, elige Wan2.7.
- Buenas prácticas de diagnóstico: Como el mensaje de error solo se devuelve una vez, guarda siempre la respuesta completa en los registros.
- Cómo empezar: Con una sola clave API de APIYI, disponible en apiyi.com, puedes probar y comparar varios modelos de video.
Resumen
Puntos clave sobre la retirada de Veo 3.1 Preview:
- Los tres modelos están descontinuados: se retiraron las versiones estándar, rápida y ligera, y el canal correspondiente de APIYI también dejó de ofrecerlas.
- El error se identifica fácilmente: si aparece
fail_to_fetch_taskjunto conis no longer available, inicia directamente el proceso de migración; no hace falta seguir buscando el problema en el código. - Hay alternativas durante la transición: antes de que Omni esté disponible, Seedance 2.0 y Wan2.7 pueden cubrir la mayoría de los casos de generación de video.
Te recomendamos sustituir cuanto antes los nombres de los modelos antiguos en el código, configurar la selección del modelo como una opción y mejorar los registros de errores para preparar la transición a Omni. Puedes comprobar rápidamente el rendimiento de los modelos alternativos en APIYI apiyi.com. La plataforma ofrece una interfaz compatible con OpenAI y créditos de prueba gratuitos para nuevos usuarios; cuando Omni esté disponible, podrás cambiar a él sin problemas desde la misma interfaz.
📚 Referencias
- Aviso de obsolescencia de la API de Google Gemini: comunicado oficial sobre la retirada de la serie Veo 3.1 Preview
- Enlace:
ai.google.dev/gemini-api/docs/deprecations -
Información: consulta la lista de modelos que se retirarán, las fechas de desactivación y los modelos alternativos recomendados oficialmente.
-
Centro de documentación de APIYI: lista de modelos obsoletos, guía para conservar los mensajes de error de la API y documentación sobre la invocación de modelos de video
- Enlace:
docs.apiyi.com - Información: se actualiza periódicamente con los modelos que se retirarán y las alternativas recomendadas, además de la documentación de parámetros de Seedance 2.0 y Wan2.7.
Autor: equipo técnico de APIYI
Consultas técnicas: si tienes algún problema durante la migración, puedes contactarnos desde la página de inicio de APIYI en apiyi.com. Encontrarás más recursos en el centro de documentación docs.apiyi.com.
