Criar um vídeo com Veo 3
Gere vídeos do Veo 3.1 de forma assíncrona pelo CometAPI com POST /v1/videos, depois consulte a tarefa e baixe o arquivo MP4 concluído.
id retornado e consulte a tarefa até que ela alcance um status terminal.
POST /v1/videos usa multipart/form-data; passe controles escalares como campos de formulário e entradas de mídia como campos de arquivo input_reference.
Escolha um modelo
Escolha um modo de entrada
Defina a duração e o tamanho
Para a rota compatível com OpenAI, useseconds para a duração e size para o tamanho de saída. Envie os valores como campos de formulário.
size como um dos valores WxH abaixo.
Fluxo da tarefa
Criar a tarefa
id retornado.Consultar a tarefa
status seja completed, failed ou error.Baixar o resultado
completed, baixe o arquivo MP4 da resposta da tarefa concluída.Autorizações
Bearer authentication. Use your CometAPI API key.
Corpo
Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.
veo3.1-fast, veo3.1 "veo3.1-fast"
Text prompt for the video job.
"A paper kite floats above a field."
Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.
4, 6, 8 "4"
Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.
"1280x720"
Optional first-frame image file for image-to-video.
Resposta
Task created. Store the returned id and poll GET /v1/videos/{task_id}.
Task ID. Use this value with retrieve and content endpoints.
"task_example"
Object type. Video tasks return video.
"video"
Model ID used for the task.
"veo3.1-fast"
Task lifecycle status. Poll until the value is completed, failed, or error.
queued, in_progress, completed, failed, error "queued"
Task progress as a coarse percentage.
0 <= x <= 1000
Task creation time as a Unix timestamp in seconds.
1779938152
Compatibility alias for id when present.
"task_example"
Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
1779938219
Temporary video delivery URL. This field appears on completed tasks.
"<temporary-video-url>"
Failure details. This field appears when the task fails.