El acceso a la API de Veo parece simple si solo lees el nombre del modelo. En producción, es un flujo de trabajo de video con comprobaciones del ciclo de vida del modelo, precios por segundo, operaciones asíncronas, opciones de resolución, costes de reintento y observabilidad a nivel de ruta. Si tu equipo está comparando Veo con Seedance, rutas estilo Sora u otro modelo de video detrás de una sola pasarela, trata el acceso como una lista de verificación en lugar de un intercambio de API de una sola línea.
Esta guía se comprobó el 17 de junio de 2026, Asia/Shanghai, frente a la documentación de video de Veo de la API de Gemini de Google, la tabla de precios de Veo 3.1 de Google, una ejecución reciente de Ahrefs MCP y una instantánea en vivo del catálogo de precios de Flatkey. El objetivo no es afirmar que todas las rutas estén listas para producción hoy. El objetivo es mostrar exactamente qué verificar antes de enviar trabajos de video facturables a través de un enrutador multiproveedor.
Respuesta rápida: qué revisar para el acceso a la API de Veo
Antes de aprobar el acceso a la API de Veo para tráfico de producción, confirma estos siete puntos:
- ID oficial del modelo: decide si el flujo de trabajo necesita
veo-3.1-generate-preview,veo-3.1-fast-generate-previewoveo-3.1-lite-generate-preview. - Estado del ciclo de vida: evita los ID más antiguos de Veo 3.0 y Veo 2.0, a menos que estés gestionando una migración corta, porque Google los enumera para el cierre del 30 de junio de 2026.
- Unidad de precios: normaliza Veo por segundos, resolución y variante antes de compararlo con proveedores de video basados en tokens o paquetes de recursos.
- Ruta de trabajo asíncrona: registra el nombre de la operación, el estado de sondeo, el recuento final de videos, la duración, la resolución, el número de reintentos y el motivo del fallo.
- Fila del catálogo de Flatkey: verifica la fila exacta del modelo, la familia del endpoint, el grupo, la etiqueta de precio y el estado de disponibilidad el día en que enrutas el tráfico.
- Regla de respaldo: decide cuándo un trabajo fallido de Veo puede cambiar a otra ruta y cuándo debe fallar de forma cerrada por motivos de calidad o presupuesto.
- Prueba de uso: ejecuta una prueba pequeña y confirma que el panel muestra el modelo seleccionado, la ruta, el estado, la unidad facturable y el propietario del costo.
Esa es la versión práctica del acceso a la API de Veo: no solo “¿puedo llamar a Veo?”, sino “¿puedo demostrar qué ruta de video se ejecutó, cuánto costó y qué sucede cuando falla?”
Lista de verificación de acceso a la API de Veo
| Elemento de la lista | Por qué importa | Pruebas que guardar |
|---|---|---|
| ID del modelo | Las variantes de Veo no son intercambiables en coste, latencia, resolución o compatibilidad de rutas. | ID oficial del modelo de Google más la fila correspondiente de Flatkey. |
| Familia de endpoint | Una ruta de video puede no comportarse como una finalización de chat, aunque el gateway exponga una interfaz compatible con OpenAI. | Tipo de endpoint, plantilla de solicitud, parámetros aceptados y forma de la respuesta. |
| Unidad de precio | Veo se enumera por segundo, mientras que otros proveedores de video pueden usar tokens, medios generados o paquetes de recursos. | Variante, resolución, segundos esperados, política de reintento y fecha de la fuente del precio. |
| Registro de operaciones asíncronas | La generación de Veo usa un flujo de envío y sondeo, por lo que una acción del usuario puede crear varios eventos internos. | ID de operación, intentos de sondeo, estado final, metadatos del video generado y número de reintentos. |
| Estado de disponibilidad | Una fila del catálogo no es lo mismo que una ruta de producción exitosa. | Estado del panel, hora de la última comprobación, respuesta de prueba y entrada del registro de uso. |
| Boundary de respaldo | Cambiar de modelo de video puede modificar el estilo, la duración, la calidad, el comportamiento de la política y el coste. | Matriz de respaldo aprobada y condiciones de fallo cerrado. |
Confirmar el modelo oficial de Veo y su ciclo de vida
La documentación de la API de Gemini de Google actualmente usa veo-3.1-generate-preview en los ejemplos de generación de Veo. La tabla de precios enumera tres IDs de vista previa de Veo 3.1: veo-3.1-generate-preview, veo-3.1-fast-generate-preview y veo-3.1-lite-generate-preview. Este es el primer lugar para comenzar una revisión de acceso a la API de Veo, porque un catálogo de gateway puede contener IDs antiguos, alias y etiquetas específicas del proveedor al mismo tiempo.
El ciclo de vida es tan importante como el ID actual. La página de precios de Google consultada para este artículo advierte que los modelos Veo 3 veo-3.0-generate-001 y veo-3.0-fast-generate-001 están obsoletos y programados para cerrarse el 30 de junio de 2026. También indica que Veo 2 veo-2.0-generate-001 está obsoleto y programado para el mismo cierre el 30 de junio de 2026. Si un ejemplo de código antiguo, una ruta guardada o un favorito del panel de control todavía apunta allí, trátelo como una tarea de migración, no como una ruta de acceso aprobada.
Normalice los precios de la API de Veo antes de comparar rutas
Para el acceso a la API de Veo, el precio destacado solo es útil después de normalizar la solicitud. El precio actual del nivel de pago de Veo 3.1 de Google se muestra por segundo en USD, con filas diferentes para las variantes Standard, Fast y Lite.
| Variante de Veo 3.1 | ID oficial del modelo | Precio verificado | Nota de planificación |
|---|---|---|---|
| Standard | veo-3.1-generate-preview |
$0.40/sec a 720p o 1080p; $0.60/sec a 4K. | Úselo cuando los requisitos de calidad justifiquen la fila predeterminada más alta. |
| Fast | veo-3.1-fast-generate-preview |
$0.10/sec a 720p; $0.12/sec a 1080p; $0.30/sec a 4K. | Pruebe la calidad de salida y la latencia antes de enrutar aquí los trabajos orientados al usuario. |
| Lite | veo-3.1-lite-generate-preview |
$0.05/sec a 720p; $0.08/sec a 1080p; 4K no compatible. | Útil para borradores de menor costo cuando no se requiere 4K. |
La página de precios de Google también señala que solo se le cobra si el video se genera correctamente. Eso no elimina la necesidad de registrar los reintentos. Una operación fallida, un prompt modificado o una nueva ejecución solicitada por el usuario todavía pueden crear otro trabajo facturable más adelante. Su lista de verificación de acceso a la API de Veo debe incluir la duración, la resolución, la variante, el estado de éxito y el número de reintentos para cada solicitud.
Si está comparando Veo con otros proveedores, utilice la comparación de precios de API de generación de video con IA más amplia como centro de normalización. No compare directamente una fila por segundo de Veo con un proveedor basado en tokens o paquetes de recursos sin traducir la forma real de la solicitud.
Trate la generación de Veo como una operación de larga duración
La guía de Veo de Google muestra un flujo de operación de larga duración: enviar la solicitud de generación, consultar la operación hasta que termine y luego recuperar el video generado. Eso hace que el acceso a la API de Veo sea diferente de una solicitud de texto normal con una sola respuesta. Su router y panel deben conservar el estado del trabajo durante las consultas, no solo capturar la primera llamada HTTP.
Un registro listo para producción debería responder a estas preguntas:
- ¿Qué aplicación, clave de equipo, entorno y flujo de trabajo crearon el trabajo de video?
- ¿Qué ID de modelo Veo, relación de aspecto, resolución, tipo de prompt y medios de entrada se usaron?
- ¿Qué ID de operación o identificador asíncrono equivalente se devolvió?
- ¿Cuántos intentos de consulta se ejecutaron antes de completarse o fallar?
- ¿El trabajo fue exitoso, falló, se canceló, se reintentó o se enroutó a otro lugar?
- ¿Cuántos videos generados se devolvieron y dónde se almacenó la salida?
- ¿Qué registro de uso y registro de costos puede conciliar finanzas más adelante?
Aquí también es donde la compatibilidad de endpoint necesita una prueba real. Una pasarela puede exponer una URL base compatible con OpenAI para muchas familias de modelos, pero la generación de video a menudo tiene campos específicos del proveedor y semántica asíncrona. Mantenga los fragmentos de código como plantillas hasta que haya probado una clave Flatkey actual, una fila de modelo Veo actual y el cuerpo exacto de la solicitud que usará su aplicación.
Verificar filas del catálogo de Flatkey antes de producción
El catálogo público de precios de Flatkey se comprobó para este artículo el 17 de junio de 2026 Asia/Shanghai. La respuesta contenía 638 filas de modelos y la versión de precios a42d372ccf0b5dd13ecf71203521f9d2. Había filas relacionadas con Veo, incluidos IDs y alias de estilo Google como veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview, veo3.1, veo3.1-fast y veo3.1-pro.
La advertencia importante: cada fila de Veo comprobada en esa instantánea mostró el estado de disponibilidad unknown_failure. Eso significa que el artículo puede usar las filas como evidencia de catálogo con fecha, pero no debe afirmar preparación para producción en vivo. El flujo de trabajo correcto para acceso a la API de Veo es abrir la página de precios de Flatkey actual, confirmar la fila exacta, verificar la etiqueta del panel, comprobar la familia del endpoint y ejecutar una pequeña prueba rápida antes de enviar tráfico de producción.
| Fila de Flatkey comprobada | Tipos de endpoint vistos | Campos de precios vistos | Estado en la instantánea |
|---|---|---|---|
veo-3.1-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.4 |
unknown_failure |
veo-3.1-fast-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.15 |
unknown_failure |
veo-3.1-lite-generate-preview |
gemini, openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
veo3.1, veo3.1-fast, veo3.1-pro |
openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
El texto público del producto de Flatkey respalda una narrativa de enrutamiento cuidadosa: una sola clave de API, precios claros, facturación unificada, un panel para claves, uso y enrutamiento, y lenguaje de conmutación automática/balanceo de carga. Mantén la prueba de implementación más limitada que la promesa de marketing. Para el acceso a la API de Veo, la prueba de aceptación debe ser un registro de solicitud real respaldado por el panel, no solo una fila de catálogo.
Establecer reglas de enrutamiento de video de varios proveedores
El failover de video es más sensible que el failover de texto. Si un trabajo de Veo falla, cambiar a otro proveedor puede modificar la duración, el estilo visual, la interpretación del prompt, los filtros de contenido, el formato de salida y el precio. Un plan de acceso a la API de Veo debe definir cuándo la reversión automática es segura y cuándo el flujo de trabajo debe detenerse para revisión humana.
| Situación | Decisión de enrutamiento sugerida | Motivo |
|---|---|---|
| Error transitorio del proveedor o tiempo de espera agotado | Reintente una vez o cambie a una ruta equivalente aprobada si el flujo de trabajo lo permite. | Protege la experiencia del usuario sin ocultar fallos repetidos. |
| ID de modelo obsoleto | Bloquee la ruta y migre a un modelo actual antes del tráfico de producción. | Evita la dependencia silenciosa de una ruta con una fecha de apagado fija. |
| Parámetro de solicitud no compatible | Falle cerrado y corrija la solicitud del cliente. | La reversión ciega normalmente repite la misma solicitud incorrecta en otro lugar. |
| Render final de alta resolución | Requiera aprobación explícita para la reversión a una ruta más costosa. | La resolución y la duración multiplican rápidamente el costo del video. |
| Borrador o iteración creativa interna | Permita una reversión de menor costo solo si las diferencias de salida son aceptables. | Los flujos de trabajo de borrador pueden tolerar más variación que el contenido orientado al cliente. |
El lado de confiabilidad de esta decisión se aborda con más detalle en el manual de balanceo de carga y failover de la API de IA. Para video, agregue restricciones de costo y de salida creativa a cada escalera de reversión.
Ejecute esta prueba de humo antes del lanzamiento
Una prueba de humo responsable de acceso a la API de Veo debe ser pequeña, controlada y fácil de inspeccionar:
- Cree o seleccione una clave Flatkey que no sea de producción.
- Elija una fila actual de Veo de la página de precios en vivo y registre su etiqueta exacta del modelo.
- Confirme la familia del endpoint y la plantilla de solicitud con el responsable del producto/documentación.
- Ejecute un trabajo de video de bajo riesgo con ajustes conocidos de duración y resolución.
- Capture el ID de la operación, la ruta de sondeo del estado, el resultado final, la unidad facturable y la entrada del registro de uso.
- Repita con un fallo controlado cuando sea posible, como un modelo obsoleto bloqueado o un parámetro no compatible.
- Decida si la ruta puede servir tráfico de producción, solo staging o solo la cola de investigación.
Si cualquiera de esas comprobaciones falla, mantenga la ruta fuera de producción. Un registro de uso ausente, una unidad de precio poco clara o un estado de disponibilidad unknown_failure no son un problema administrativo para video; cambian el costo, el soporte y las expectativas del cliente.
Preguntas frecuentes
¿Cómo obtengo acceso a la API de Veo?
Empieza con la documentación actual de la API Gemini de Google para Veo y los requisitos de facturación, y luego verifica el ID del modelo, el endpoint y el precio el día que construyas. Si usas Flatkey para el enrutamiento, revisa el catálogo de precios actual y el panel antes de considerar el acceso a la API de Veo listo para producción.
¿Qué ID de modelo Veo debo usar?
La tabla de precios actual de Veo 3.1 de Google enumera veo-3.1-generate-preview, veo-3.1-fast-generate-preview y veo-3.1-lite-generate-preview. Evita los ID antiguos de Veo 3.0 y Veo 2.0 para nuevos trabajos de producción porque Google los indica para el apagado del 30 de junio de 2026.
¿Cómo se calcula el precio de la API de Veo?
Google muestra precios de nivel de pago de Veo 3.1 por segundo, con tarifas diferentes según la variante y la resolución. Para el acceso a la API de Veo, normaliza los segundos esperados, la resolución, la política de éxito y los reintentos antes de comparar la ruta con proveedores de vídeo basados en tokens o paquetes de recursos.
¿Se puede enrutar Veo junto con otros modelos de generación de vídeo?
Sí, pero solo después de definir el contrato de la ruta. Un fallback de Veo a otro modelo de vídeo puede cambiar la calidad visual, la duración, el formato de salida, el comportamiento de moderación y el coste. Usa reglas de fallback aprobadas en lugar de reintentos automáticos genéricos.
¿Qué deben verificar los usuarios de Flatkey antes de producción?
Verifica la fila actual del modelo, la familia del endpoint, la etiqueta del panel, el estado de disponibilidad, la etiqueta de precio, los campos del registro de uso y un resultado real de prueba rápida. En la instantánea del 17 de junio de 2026 usada para este artículo, existían filas de Veo pero mostraban unknown_failure, así que el uso en producción requiere una confirmación reciente.
Conclusión final
El acceso a la API de Veo es una decisión de producción, no solo una casilla del proveedor. Confirme el modelo oficial, normalice los segundos y la resolución, gestione trabajos asíncronos, verifique la fila actual de Flatkey y la evidencia del panel, y documente los límites de fallback antes de la primera solicitud de video orientada al cliente.
Para evaluar Veo junto con el resto de su stack de modelos de video, comience con el catálogo actual de precios de Flatkey y use la lista de verificación anterior para decidir qué rutas están listas para staging, cuáles necesitan una prueba de humo y cuáles deben permanecer en el backlog de investigación.
