El acceso a la API de Veo ya no es un cambio de modelo de una sola línea para los equipos de medios. Antes de poner el tráfico de creadores detrás de los modelos de video de Google, necesitas verificar el ID del modelo, el acceso directo del proveedor, la unidad de precios, el comportamiento de los trabajos asíncronos, el estado de la ruta, la política de fallback y la prueba de uso posterior a la generación. Ese es el propósito de esta Checklist de acceso a la API Veo para enrutamiento de video multi-proveedor.
Usa esta checklist cuando estés decidiendo si Veo debería ser tu ruta de video predeterminada, una ruta dentro de una política multi-proveedor, o un flujo de trabajo directo de Google que se sitúa fuera de un gateway. Está escrita para equipos de producto, ingeniería y operaciones de medios que necesitan comprobaciones repetibles antes de llevar a producción trabajos de texto a video e imagen a video.
Esta Checklist de acceso a la API Veo para enrutamiento de video multi-proveedor fue verificada el 15 de septiembre de 2026 frente a la documentación de la API de Google Gemini, los precios de la API de Google Gemini, las páginas de modelos de Flatkey, la documentación de inicio rápido de Flatkey y el directorio de modelos de Flatkey. Trata cada precio y estado de ruta como una instantánea pública con fecha, y luego vuelve a comprobar los términos de tu cuenta antes de mover tráfico de producción.
Respuesta rápida: Qué comprobar para el acceso a la API de Veo
Si solo tienes tiempo para una pasada, verifica estos siete campos antes de enrutar trabajos de producción:
| Comprobación | Por qué importa | Instantánea apta para publicar |
|---|---|---|
| Familia de modelos directos de Google | Google ahora separa la guía general de generación de video de la documentación específica de Veo. | La descripción general de video de Google dice que Gemini API ofrece Gemini Omni Flash y Veo; recomienda Gemini Omni Flash como el modelo de video predeterminado y Veo 3.1 cuando necesitas extensión de escenas, control del último fotograma o flujos de trabajo heredados de Veo. |
| ID del modelo Veo | Los trabajos de producción deben fijar IDs exactos de modelo, no solo "Veo". | La documentación de Veo de Google enumera veo-3.1-generate-preview, veo-3.1-fast-generate-preview y veo-3.1-lite-generate-preview; las páginas públicas de modelos de Flatkey verificaron las rutas Standard y Fast, mientras que la página del modelo Lite de Flatkey devolvió 404 durante esta actualización. |
| Unidad de precios | Los costos de video se acumulan por segundos, resolución, clips aceptados y reintentos. | Google enumera los precios de Veo 3.1 por segundo. Las páginas de modelos de Flatkey muestran precios de ruta por segundo para Standard y Fast con precios "desde". |
| Modelo de trabajo asíncrono | La generación de video es un flujo de trabajo de producción en cola. | Google documenta la generación de Veo mediante una operación de larga duración: enviar, consultar hasta done y luego descargar el archivo. |
| Restricciones de salida | La duración, la relación de aspecto, la resolución, el audio y los controles de referencia determinan si una alternativa es válida. | Google documenta opciones de duración de 4 s, 6 s y 8 s, 16:9 y 9:16, audio nativo, opciones de 720p/1080p/4k y restricciones de imagen de referencia/extensión según el modelo. |
| Estado de la ruta del gateway | Una ruta de gateway solo es útil si la ruta específica está disponible y es observable. | Las páginas de modelos de Flatkey comprobadas para Standard y Fast mostraron availability_status: available e incluían familias de endpoints como openai-video, gemini y openai. |
| Prueba de uso | Finanzas y operaciones necesitan pruebas después de que el trabajo se complete. | La documentación de inicio rápido de Flatkey describe el uso de https://router.flatkey.ai/v1, configuración compatible con el SDK de OpenAI y Usage Logs para revisar el modelo, los tokens, la latencia y el costo. |
La versión corta: ejecuta esta Lista de comprobación de acceso a la API Veo para enrutamiento de video multi-proveedor antes de comparar la calidad creativa. Una demo de prompt puede verse bien mientras que la ruta de producción aún carece de evidencia de facturación, comportamiento de cola o un contrato de fallback válido.
Lista de comprobación de acceso a la API Veo para enrutamiento de video multi-proveedor
Usa esta Lista de comprobación de acceso a la API Veo para enrutamiento de video multi-proveedor como el filtro de lanzamiento. Marca una fila como completa solo cuando se hayan verificado el entorno exacto, la cuenta, el ID del modelo, la ruta y la superficie de facturación.
| Paso | Evidencia requerida | Condición de aprobación |
|---|---|---|
| 1. Confirmar la clase de ruta de video | API Gemini directa, ruta Flatkey o política mixta multi-proveedor. | El equipo sabe si el cliente está llamando directamente a Google, al enrutador de Flatkey o a ambos. |
| 2. Elegir el ID exacto del modelo Veo | veo-3.1-generate-preview o veo-3.1-fast-generate-preview para rutas Flatkey verificadas; los equipos que usan Google directamente también pueden evaluar Lite. | Ninguna tarea usa un alias genérico veo en la configuración de producción. |
| 3. Congelar el contrato de salida | Tipo de prompt, imágenes de referencia, relación de aspecto, resolución, duración, expectativa de audio nativo, requisito de extensión. | La ruta de respaldo puede conservar la misma promesa visible para el usuario o el trabajo no es elegible para respaldo. |
| 4. Normalizar la tarificación | Precio por segundo, duración, resolución, política de reintento, tasa de clips aceptados. | La aprobación usa el coste estimado por clip aceptado, no solo el precio bruto por segundo. |
| 5. Implementar manejo asíncrono | Tabla de trabajos, ID de operación, sondeo/backoff, tiempo de espera, ruta de cancelación, traspaso a almacenamiento. | La app puede sobrevivir a trabajos de larga duración y a finalizaciones retrasadas sin sorpresas de doble cobro. |
| 6. Comprobar el estado de la ruta | Acceso del proveedor, estado de la ruta Flatkey, solicitud de prueba, clase de error, margen de latencia. | Una prueba rápida registra ID de solicitud, ID del modelo, duración, ruta, estado de finalización y coste. |
| 7. Establecer la política de respaldo | Proveedores de respaldo permitidos, comportamiento de salida bloqueada, presupuesto de reintentos, mensaje de degradación. | El respaldo no puede cambiar silenciosamente la duración del clip, la relación de aspecto ni la promesa de audio. |
| 8. Verificar la observabilidad | Registros, libro mayor de costes, ruta, recuento de reintentos, URL final del activo, decisión del revisor. | Producto, ingeniería y finanzas pueden inspeccionar el mismo registro del trabajo. |
| 9. Volver a comprobar antes del lanzamiento | Documentación de Google, precios de Google, página del modelo en Flatkey, página de precios de Flatkey, runbook interno. | Los precios y la disponibilidad están fechados en la nota de la versión. |
Para una política de ruta más amplia, combine esta lista de verificación con la guía de Flatkey sobre enrutamiento de agentes multimodales. Para interpretar el catálogo, use la guía del catálogo de modelos de IA antes de aprobar una fila de modelo.
Confirmar si Veo es la ruta de video de Google adecuada
La primera pregunta de acceso no es "¿Podemos llamar a Veo?" Es "¿Debería este flujo de trabajo usar Veo u otro modelo de video de Google?" La descripción general de video de la API Gemini de Google dice que ofrece tanto Gemini Omni Flash como Veo. La misma descripción general posiciona a Gemini Omni Flash como el modelo de video predeterminado y dirige a los equipos a Veo 3.1 cuando necesitan extensión de escenas, control del último fotograma o pipelines Veo más antiguos.
Esa distinción importa porque el acceso a la API Veo a menudo entra en una hoja de ruta a través de un requisito creativo: mejor movimiento cinematográfico, salida de alta resolución, audio nativo, control de referencias o extensión a partir de una escena generada existente. Si el trabajo es comprensión general de video o trabajo multimodal amplio, su decisión de ruta puede ser diferente.
Use Veo cuando el trabajo dependa de una o más de estas propiedades:
- Clips cortos generados con audio nativo.
- Salida en 720p, 1080p o 4k, donde lo admita el modelo y la cuenta seleccionados.
- Salida
16:9o9:16con una duración controlada. - Comportamiento de primer fotograma, último fotograma o extensión.
- Gobernanza de la cuenta de Google o semántica de operación directa de la API de Gemini.
Usa una ruta de gateway cuando el equipo necesite comparar Veo con otros proveedores de generación de video, centralizar el gasto o mantener un proceso consistente de revisión de rutas en modelos de texto, imagen, audio y video. La comparación Seedance vs Veo API es la lectura interna adyacente cuando la decisión es específicamente Veo frente a Seedance.
Elige el ID del modelo Veo actual
En esta Checklist de acceso a la API Veo para enrutamiento de video multi-proveedor, la regla del ID de modelo es simple: no configures "Veo" como etiqueta de producción. Configura un ID de modelo exacto y registra por qué se eligió.
| ID del modelo | Dónde está documentado | Úsalo cuando | Estado de ruta de Flatkey verificado en esta actualización |
|---|---|---|---|
veo-3.1-generate-preview | Documentación y precios de Google Veo; página pública del modelo en Flatkey. | Necesitas la ruta estándar de Veo 3.1 y puedes aceptar el mayor costo de la ruta. | La página pública de Flatkey devolvió 200 y mostró metadatos de ruta disponibles. |
veo-3.1-fast-generate-preview | Documentación y precios de Google Veo; página pública del modelo en Flatkey. | Quieres una vía de Veo más rápida y de menor costo, y has probado la calidad para tu clase de prompts. | La página pública de Flatkey devolvió 200 y mostró metadatos de ruta disponibles. |
veo-3.1-lite-generate-preview | Documentación y precios de Google Veo. | Estás evaluando el comportamiento directo de Google Lite y sus restricciones. | La página pública del modelo Lite de Flatkey devolvió 404 durante esta actualización, por lo que este artículo no afirma una ruta Lite activa en Flatkey. |
La documentación de Google marca la familia Veo 3.1 como vista previa. Trátalo como una restricción de gestión de lanzamientos: tu checklist de producción debe incluir comprobaciones de acceso con fecha, permisos de la cuenta, regiones permitidas si son relevantes para tu despliegue, comportamiento de bloqueo por seguridad, pruebas de latencia y una ruta de reversión.
Normaliza los precios de la API Veo antes de enrutarlos
La Checklist de acceso a la API Veo para enrutamiento de video multi-proveedor debe comparar los precios como un costo por trabajo, no como un costo por nombre de modelo. Parte de la duración y la resolución exactas que expone tu producto y luego suma la tasa de reintentos y la tasa de clips aceptados.
| Ruta | Instantánea de precios públicos verificada el 15 de septiembre de 2026 | Ejemplo de planificación de 8 segundos | Notas |
|---|---|---|---|
Google directo veo-3.1-generate-preview | $0.40/sec a 720p o 1080p; $0.60/sec a 4k. | $3.20 a 720p/1080p; $4.80 a 4k. | Google dice que el nivel gratuito no está disponible para Veo 3.1 y que solo cobra si el video se genera correctamente. |
Google directo veo-3.1-fast-generate-preview | $0.10/sec a 720p; $0.12/sec a 1080p; $0.30/sec a 4k. | $0.80 a 720p; $0.96 a 1080p; $2.40 a 4k. | Buen candidato para borradores o para carriles de video de Google de menor costo después de probar la calidad. |
Google directo veo-3.1-lite-generate-preview | $0.05/sec a 720p; $0.08/sec a 1080p; 4k no compatible. | $0.40 a 720p; $0.64 a 1080p. | En este artículo solo se verificó el precio directo de Google; la ruta Flatkey Lite no se verificó. |
Flatkey veo-3.1-generate-preview | La página del modelo mostraba precios por segundo desde $0.32/sec. | Desde $2.56 por 8 segundos. | Verifica la configuración de la ruta en vivo y la facturación antes del lanzamiento. |
Flatkey veo-3.1-fast-generate-preview | La página del modelo mostraba precios por segundo desde $0.08/sec. | Desde $0.64 por 8 segundos. | Verifica la configuración de la ruta en vivo y la facturación antes del lanzamiento. |
El principal error de enrutamiento es aprobar una ruta de respaldo porque parece más barata por segundo y luego descubrir que cambia la resolución, el comportamiento del audio, el control de referencias o la tasa de clips aceptados. Ejecuta la comparación final como:
accepted_clip_cost:
total_generation_cost: "$ facturado por todos los intentos"
accepted_clips: "clips que pasaron QA de marca, seguridad, movimiento y canal"
formula: "total_generation_cost / accepted_clips"Si una ruta tiene un costo bruto menor pero produce más clips rechazados, el costo real de producción puede ser más alto.
Trata Veo como un trabajo de video asíncrono
La documentación de Veo de Google usa un patrón de operación de larga duración. Un cliente envía una solicitud de generación, recibe un objeto de operación, consulta hasta que la operación termina y luego descarga el video generado. La documentación de Google también indica que los videos generados se almacenan durante dos días y deben descargarse dentro de esa ventana.
Eso significa que el acceso a la API Veo necesita un sistema de trabajos, no solo un contenedor de solicitudes. Tu cliente debe registrar:
- ID interno del trabajo.
- ID de operación del proveedor o ID de solicitud de gateway.
- ID del modelo.
- Tipo de entrada y activos de referencia.
- Duración, resolución y relación de aspecto.
- Hora de inicio, número de consultas, hora de finalización, estado de tiempo de espera.
- Bloqueo por seguridad, error del proveedor, número de reintentos y ruta de respaldo si se usó.
- Ubicación final del activo y política de retención/eliminación.
- Importe final facturado y enlace al registro de uso.
Para los usuarios de Flatkey, el inicio rápido de la API de Flatkey es el siguiente paso para la configuración de la URL base. El inicio rápido documenta https://router.flatkey.ai/v1 y una configuración compatible con el SDK de OpenAI; para video en producción, mantén la misma disciplina, pero realiza una prueba rápida del endpoint de video específico y de la ruta del modelo que pretendes usar.
Verificar el estado de la ruta de Flatkey y la familia de endpoints
La verificación de la ruta de Flatkey debe hacerse en la página del modelo y en los registros de tu propia cuenta.
Para esta actualización, las páginas públicas de modelos de Flatkey devolvieron 200 para:
https://flatkey.ai/models/veo-3.1-generate-previewhttps://flatkey.ai/models/veo-3.1-fast-generate-preview
Esas páginas mostraban a Google como proveedor, availability_status: available, precios por segundo y familias de endpoints que incluyen openai-video, gemini y openai. La página pública de veo-3.1-lite-generate-preview devolvió 404, así que la afirmación segura es limitada: Google documenta Lite directamente, pero esta actualización no verificó una ruta Lite de Flatkey.
Antes de producción, captura una captura de pantalla o una exportación de la fila del modelo, luego ejecuta una pequeña prueba rápida y confirma que aparece en los registros de uso. El directorio de modelos y la página de precios de Flatkey deben formar parte de la lista de verificación de lanzamiento con fecha.
Establecer reglas de fallback entre proveedores de video
El fallback es más difícil para video que para texto. Un fallback de modelo de texto puede preservar la intención con un estilo diferente. Un fallback de modelo de video puede cambiar la duración del clip, el comportamiento de la cámara, la fidelidad a la referencia, el audio, la resolución, el costo y el resultado de moderación.
Usa esta matriz de fallback antes de habilitar reintentos automáticos:
| Clase de fallo | ¿Reintentar la misma ruta? | ¿Se permite fallback? | Nota para el operador |
|---|---|---|---|
| Error transitorio de ruta | Sí, dentro de un presupuesto de reintentos limitado. | Sí, si el contrato de salida es equivalente. | Preserva la idempotencia para que los reintentos no creen cargos duplicados al usuario. |
| Bloqueo de seguridad o política | No hay reintento automático sin un cambio en la entrada. | Por lo general, no. | Pide una revisión del prompt o de la referencia en lugar de cambiar de proveedor de forma silenciosa. |
| Se supera el umbral de latencia | Quizá, si el trabajo no es visible para el usuario. | Sí, para rutas de borrador. | Muestra el estado de progreso y evita reintentos ocultos repetidos. |
| Se alcanza el límite de presupuesto | No. | No, salvo que una ruta más barata esté preaprobada. | Los límites de presupuesto deben detener el trabajo, no ocultar el gasto. |
| Funcionalidad no compatible | No. | Solo si el fallback admite la funcionalidad requerida. | No hagas fallback de requisitos de audio nativo a video silencioso sin una decisión de producto. |
Para equipos de video multi-proveedor, la clave es enrutar por clase de flujo de trabajo:
- Clips de Google con audio nativo.
- Clips de borrador Veo de menor costo.
- Clips de creador con alta dependencia de referencia.
- Trabajos de video social más largos.
- Trabajos de exportación en alta resolución.
- Trabajos de revisión manual en los que las salidas bloqueadas deben volver a un editor.
Aquí es donde ayuda una pasarela unificada: ofrece a ingeniería un único lugar para enrutar, a producto un único lugar para definir la política del modelo y a finanzas un único libro mayor para revisar. No elimina la necesidad de verificar el comportamiento exacto de salida de cada ruta.
Ejecute la prueba de humo de lanzamiento
Ejecute esta prueba de humo de la Checklist de acceso a la API Veo para enrutamiento de video multi-proveedor en staging antes de abrir el acceso a la API Veo al tráfico de creadores:
- Cree tres trabajos representativos: un clip horizontal solo con prompt, un clip vertical referenciado por imagen y un clip con audio nativo.
- Ejecute cada trabajo en la ruta Veo elegida con la duración y la resolución exactas previstas para producción.
- Registre el ID de operación, el ID de solicitud, el ID del modelo, la ruta, la hora de inicio, la hora de finalización y la URL de salida.
- Verifique que el trabajo aparezca en Flatkey Usage Logs o en los registros directos de uso de Google.
- Confirme que el costo total coincida con la unidad esperada por segundo, la duración y la resolución.
- Fuerce un fallo recuperable y confirme que la idempotencia evita registros finales duplicados.
- Fuerce un trabajo bloqueado o rechazado y confirme que la interfaz solicite una entrada revisada en lugar de hacer un fallback silencioso.
- Confirme que los activos generados se descarguen y almacenen antes de que expire la ventana de retención del proveedor.
- Revise las pruebas finales con producto, ingeniería y finanzas antes del lanzamiento.
Registro de acceso a Veo copiable
Use este registro de la Checklist de acceso a la API Veo para enrutamiento de video multi-proveedor en su checklist de lanzamiento o repositorio de enrutamiento:
veo_access_record:
checked_at: "YYYY-MM-DD"
owner: "team or person"
route_mode: "direct_google | flatkey | mixed"
model_id: "veo-3.1-fast-generate-preview"
provider_docs_checked:
- "Google Gemini API video overview"
- "Google Gemini API Veo docs"
- "Google Gemini API pricing"
flatkey_checks:
model_page_status: "200"
availability_status: "available"
endpoint_family: "openai-video"
usage_logs_verified: true
output_contract:
duration_seconds: 8
aspect_ratio: "16:9"
resolution: "720p"
native_audio_required: true
reference_images_required: 0
cost_review:
billing_unit: "per_second"
displayed_unit_price: "record current account/page value"
retry_budget: "max attempts"
accepted_clip_cost_target: "USD"
async_handling:
operation_id_saved: true
polling_backoff: "configured"
timeout_policy: "configured"
asset_download_window: "before provider expiry"
fallback_policy:
enabled: false
allowed_routes: []
contract_preserved: true
rollback:
owner: "team or person"
trigger: "error rate, cost, latency, quality, safety"
action: "disable route or switch workflow class"Preguntas frecuentes
¿Cómo obtengo acceso a la API Veo?
Comience con la documentación de la API Gemini de Google y el acceso a su cuenta de Google, luego decida si la ruta debe ejecutarse directamente a través de Google o mediante una pasarela como Flatkey. Use la Checklist de acceso a la API Veo para enrutamiento de video multi-proveedor para verificar la página del modelo en vivo y ejecutar una solicitud en staging antes del tráfico de producción.
¿Qué ID de modelo Veo debo usar?
Usa veo-3.1-generate-preview cuando necesites la ruta estándar de Veo 3.1. Usa veo-3.1-fast-generate-preview cuando la calidad Fast se ajuste a tu flujo de trabajo y la ruta de menor coste por segundo sea adecuada. Evalúa veo-3.1-lite-generate-preview solo frente a la documentación directa de Google, a menos que tu cuenta de Flatkey o la página del modelo confirmen una ruta Lite activa.
¿Cómo se calcula el precio de la API Veo?
Google publica los precios de Veo 3.1 por segundo generado, con tarifas distintas según el modelo y la resolución. Las páginas de modelos de Flatkey también muestran precios de ruta por segundo para las páginas verificadas de Veo Standard y Fast. Tu revisión de producción debería multiplicar el precio unitario por la duración, la resolución, los reintentos y la tasa de clips aceptados.
¿Puede Veo enrutarse con otros modelos de generación de video?
Sí, pero el fallback debe preservar el contrato de salida visible para el usuario. No hagas fallback automáticamente de un trabajo de Veo con audio nativo, 8 segundos y 1080p a un trabajo silencioso, más corto y de menor resolución, a menos que el producto permita explícitamente esa degradación.
¿Qué deben verificar los usuarios de Flatkey antes de producción?
Comprueba la página del modelo de Flatkey, el directorio de modelos, la página de precios, el estado de la ruta y los registros de uso. Luego ejecuta una prueba rápida específica de video en lugar de asumir que un inicio rápido de texto compatible con OpenAI demuestra el comportamiento de video.
Conclusión final
La checklist de acceso a la API Veo para enrutamiento de video multi-proveedor debe terminar con evidencia fechada, no con una preferencia. Congela el ID del modelo, normaliza el precio por clip aceptado, diseña para trabajos asíncronos, verifica la ruta de Flatkey o la cuenta directa de Google, y aprueba el fallback solo cuando preserve el contrato de salida. Después, usa el directorio de modelos, la página de precios, el inicio rápido y los registros de uso de Flatkey para mantener auditable la ruta de producción después del lanzamiento.
