Descripción general
Referencia de la API
Guías de integración
Errores
Precios y facturación
Wrapper de CometAPI
Generación asíncrona de video
Genera videos de Veo3 de forma asíncrona mediante POST /v1/videos en CometAPI, devolviendo un id de tarea y admitiendo guía de primer/último fotograma para clips de 8 segundos.
POST
/
v1
/
videos
Create a Veo video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper kite floats above a field.' \
--form input_reference='@example-file'{
"created_at": 1773297229,
"id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
"model": "veo_3_1-4K",
"object": "video",
"progress": 0,
"seconds": "",
"size": "16x9",
"status": "queued"
}Usa esta página para iniciar un trabajo de Veo a través de la ruta compartida
/v1/videos de CometAPI. Elige un alias actual de Veo en la página de Models al configurar model.
Elige el patrón de solicitud
- Texto a video: no envíes archivos
input_reference - Imagen a video: envía un
input_reference - Guía de primer y último fotograma: envía dos archivos
input_referenceordenados
Flujo de la tarea
Envía el trabajo de Veo
Envía un alias de Veo, prompt e imágenes de entrada opcionales, y luego guarda el
id devuelto.Consulta el endpoint de video compartido
Usa Veo3 Retrieve para seguir la tarea asíncrona hasta que alcance un estado terminal.
Resolución de alias
Google documenta Veo a través de las operaciones de video de larga duración de Gemini y usa nombres de modelo comoveo-3.1-generate-preview. CometAPI mantiene la ruta compartida /v1/videos y resuelve un alias actual de Veo desde la página de Models en el momento de la solicitud. Durante la validación en vivo realizada el 2026-03-12, una solicitud con veo3-fast fue aceptada y devolvió un id de tarea asíncrona, y el model de la respuesta se resolvió a un id de modelo del proveedor en lugar de reflejar el alias enviado.Autorizaciones
Bearer token authentication. Use your CometAPI key.
Cuerpo
multipart/form-data
Text prompt for the video job.
Ejemplo:
"A paper kite floats above a field."
CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.
Ejemplo:
"veo3-fast"
Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.
Ejemplo:
"16x9"
Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.
⌘I
Create a Veo video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper kite floats above a field.' \
--form input_reference='@example-file'{
"created_at": 1773297229,
"id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
"model": "veo_3_1-4K",
"object": "video",
"progress": 0,
"seconds": "",
"size": "16x9",
"status": "queued"
}