Saltar al contenido principal
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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 fotograma y último fotograma: envía dos archivos input_reference ordenados

​
Flujo de la tarea

1

Envía el trabajo de Veo

Envía un alias de Veo, un prompt y entradas de imagen opcionales, y luego guarda el id devuelto.
2

Consulta el endpoint de video compartido

Usa Veo3 Retrieve para seguir la tarea async hasta que alcance un estado terminal.
3

Guarda el resultado

Mueve el recurso finalizado a tu propio almacenamiento si tu aplicación necesita una copia duradera.

​
Resolución de alias

El campo model en la respuesta puede mostrar el id del modelo backend resuelto en lugar del alias que enviaste. Usa la página de Models para encontrar los alias actuales de Veo.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

multipart/form-data
​
prompt
string
requerido

Text prompt for the video job.

Ejemplo:

"A paper kite floats above a field."

​
model
string
predeterminado:veo3-fast

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"

​
size
string

Orientation hint. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

Ejemplo:

"16x9"

​
input_reference
file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

Respuesta

200 - application/json

Task accepted.

​
created_at
integer
requerido
​
id
string
requerido
​
model
string
requerido

Provider model identifier resolved by CometAPI for this task.

​
object
string
requerido
​
progress
integer
requerido
​
seconds
string
requerido
​
size
string
requerido
​
status
string
requerido