Skip to main content
POST
Cree un vídeo Veo 3.1 a partir de texto o una imagen. La API devuelve un ID de tarea de inmediato. Guarde el id devuelto para consultar la tarea y descargar el vídeo completado. POST /v1/videos utiliza multipart/form-data. Envíe los controles como campos de formulario y una imagen como un campo de archivo input_reference.

​
Elija un modelo

​
Elija un modo de entrada

Para animar una imagen, cargue un archivo mediante input_reference, utilizando el campo una sola vez. La imagen establece el fotograma inicial; prompt describe el movimiento y el comportamiento de la cámara posteriores.

​
Configure la duración y el tamaño

Para esta ruta compatible con OpenAI, establezca la duración con un valor entero explícito de seconds y el tamaño de salida con size. Envíe ambos valores como campos de formulario. Establezca size en uno de los valores WxH siguientes.

​
Flujo de tareas

1

Crear la tarea

Envíe la solicitud de formulario multipart y almacene el id devuelto.
2

Consultar la tarea

Utilice Veo3 Retrieve hasta que status sea completed, failed o error.
3

Descargar el resultado

Cuando la tarea esté completed, descargue el archivo MP4 de la respuesta de la tarea completada.

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication. Use your CometAPI API key.

Cuerpo

multipart/form-data
​
model
enum<string>
requerido

Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.

Opciones disponibles:
veo3.1-fast,
veo3.1
Ejemplo:

"veo3.1-fast"

​
prompt
string
requerido

Text prompt for the video job.

Ejemplo:

"A paper kite floats above a field."

​
seconds
enum<integer>
predeterminado:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

Opciones disponibles:
4,
6,
8
Ejemplo:

4

​
size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

Ejemplo:

"1280x720"

​
input_reference
file

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

Respuesta

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

​
id
string
requerido

Task ID. Use this value with retrieve and content endpoints.

Ejemplo:

"task_example"

​
object
string
requerido

Object type. Video tasks return video.

Ejemplo:

"video"

​
model
string
requerido

Model ID used for the task.

Ejemplo:

"veo3.1-fast"

​
status
enum<string>
requerido

Task lifecycle status. Poll until the value is completed, failed, or error.

Opciones disponibles:
queued,
in_progress,
completed,
failed,
error
Ejemplo:

"queued"

​
progress
integer
requerido

Task progress as a coarse percentage.

Rango requerido: 0 <= x <= 100
Ejemplo:

0

​
created_at
integer
requerido

Task creation time as a Unix timestamp in seconds.

Ejemplo:

1779938152

​
task_id
string

Compatibility alias for id when present.

Ejemplo:

"task_example"

​
completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Ejemplo:

1779938219

​
video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Ejemplo:

"<temporary-video-url>"

​
error
object

Failure details. This field appears when the task fails.

Última modificación el 9 de septiembre de 2026