Skip to main content
POST
cURL
Usa este endpoint para iniciar una tarea de video de Veo 3.1. La API devuelve un ID de tarea de inmediato, así que guarda el id devuelto y consulta la tarea hasta que alcance un estado terminal. POST /v1/videos usa multipart/form-data; pasa los controles escalares como campos del formulario y las entradas de medios como campos de archivo input_reference.

Elige un modelo

Elige un modo de entrada

Configura la duración y el tamaño

Para la ruta compatible con OpenAI, usa seconds para la duración y size para el tamaño de salida. Envía los valores como campos del formulario. Configura size con uno de los valores WxH que aparecen a continuación.

Flujo de la tarea

1

Crear la tarea

Envía la solicitud de formulario multipart y guarda el id devuelto.
2

Consultar la tarea

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

Descargar el resultado

Cuando la tarea esté completed, descarga el archivo MP4 desde 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<string>
predeterminado:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

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

Optional first-frame image file for image-to-video.

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.