创建 Veo 3 视频

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

通过文本或图像创建 Veo 3.1 视频。API 会立即返回任务 ID。保存返回的 id，以便轮询任务并下载完成的视频。 POST /v1/videos 使用 multipart/form-data。将控制参数作为表单字段发送，并将图像作为 input_reference 文件字段发送。

选择模型

模型 ID	适用场景	说明
`veo3.1-fast`	大多数短视频的默认选择	更快的 Veo 3.1 路由。
`veo3.1`	当你明确希望使用标准 Veo 3.1 模型时使用	标准 Veo 3.1 路由。

选择输入模式

目标	必填字段	可选字段
文本生成视频	`model`, `prompt`	`seconds`, `size`
图像生成视频	`model`, `prompt`，一个 `input_reference` 图像文件	`seconds`, `size`

要让图像动起来，请通过 input_reference 上传一个文件，并且仅使用一次该字段。图像将设定开场帧；prompt 描述后续的运动和镜头行为。

设置时长和尺寸

对于此 OpenAI 兼容路由，使用明确的整数 seconds 值设置时长，并使用 size 设置输出尺寸。将两个值都作为表单字段发送。

模型 ID	`seconds`	默认值
`veo3.1-fast`	`4`, `6`, `8`	`4` 秒， `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` 秒， `1280x720`

将 size 设置为以下 WxH 值之一。

分辨率级别	宽高比	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

任务流程

创建任务

发送 multipart 表单请求，并保存返回的 id。

轮询任务

使用 Veo3 Retrieve 直到 status 为 completed、failed 或 error。

下载结果

当任务状态为 completed 时，从已完成任务的响应中下载 MP4 文件。

授权

Authorization

string

header

必填

Bearer authentication. Use your CometAPI API key.

请求体

multipart/form-data

model

enum<string>

必填

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"

prompt

string

必填

Text prompt for the video job.

示例:

"A paper kite floats above a field."

seconds

enum<integer>

默认值:4

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

可用选项:

4,

6,

8

示例:

4

size

string

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

示例:

"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.

响应

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

string

必填

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

示例:

"task_example"

object

string

必填

Object type. Video tasks return video.

示例:

"video"

model

string

必填

Model ID used for the task.

示例:

"veo3.1-fast"

status

enum<string>

必填

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

可用选项:

queued,

in_progress,

completed,

failed,

error

示例:

"queued"

progress

integer

必填

Task progress as a coarse percentage.

必填范围: 0 <= x <= 100

示例:

0

created_at

integer

必填

Task creation time as a Unix timestamp in seconds.

示例:

1779938152

task_id

string

Compatibility alias for id when present.

示例:

"task_example"

completed_at

integer

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

示例:

1779938219

video_url

string

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

示例:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

最后修改于 2026年9月9日

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

内容审核

API 密钥

选择模型

选择输入模式

设置时长和尺寸

任务流程

授权

请求体

响应

​选择模型

​选择输入模式

​设置时长和尺寸

​任务流程

授权

请求体

响应

选择模型

选择输入模式

设置时长和尺寸

任务流程