创建 Veo 3 视频
通过 CometAPI 使用 POST /v1/videos 异步生成 Veo 3.1 视频,然后轮询任务并下载已完成的 MP4 文件。
id,并轮询任务直到其达到终态状态。
POST /v1/videos 使用 multipart/form-data;将标量控制项作为表单字段传递,将媒体输入作为 input_reference 文件字段传递。
选择模型
选择输入模式
设置时长和尺寸
对于 OpenAI 兼容路由,使用seconds 表示时长,使用 size 表示输出尺寸。将这些值作为表单字段发送。
size 设置为以下 WxH 值之一。
任务流程
创建任务
id。轮询任务
status 变为 completed、failed 或 error。下载结果
completed 时,从已完成的任务响应中下载 MP4 文件。授权
Bearer authentication. Use your CometAPI API key.
请求体
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.
响应
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.