Veo 视频生成

Veo API 使用统一 /v1/videos 视频任务接口，支持文生视频、参考图视频和首尾帧视频。提交任务后通过轮询获取结果。

接口概览

能力	方法	路径
提交任务	`POST`	`/v1/videos`
查询任务	`GET`	`/v1/videos/{task_id}`

所有接口都使用：

Authorization: Bearer $API_KEY

可用模型

模型	模式	说明
`veo_3_1`	文生视频 / 多图参考	标准速度、标准画质
`veo_3_1-hd`	文生视频 / 多图参考	标准速度、高清
`veo_3_1-fl`	首尾帧	标准速度、标准画质
`veo_3_1-hd-fl`	首尾帧	标准速度、高清
`veo_3_1-fast-fl`	首尾帧	快速、标准画质
`veo_3_1-fast-fl-hd`	首尾帧	快速、高清

不带 -fl 的模型可不传图片，也可传 1 到 3 张参考图。带 -fl 的模型用于首尾帧，传 1 到 2 张图。

请求参数

参数	类型	必填	说明
`model`	string	是	Veo 模型名称
`prompt`	string	是	视频提示词
`size`	string	否	例如 `1280x720`、`720x1280`
`images`	string[]	否	JSON 方式传参考图 URL
`input_reference[]`	repeatable	否	表单方式传参考图 URL 或文件

提交任务

curl https://cdn.12ai.org/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1",
    "prompt": "一只小猫在花园里玩耍，柔和阳光，电影镜头",
    "size": "1280x720"
  }'

curl https://cdn.12ai.org/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1-hd",
    "prompt": "根据参考图生成自然运动的视频",
    "size": "1280x720",
    "images": [
      "https://example.com/reference-1.jpg"
    ]
  }'

curl https://cdn.12ai.org/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1-fast-fl-hd",
    "prompt": "从第一张图自然过渡到第二张图，镜头平稳",
    "size": "1280x720",
    "images": [
      "https://example.com/first.jpg",
      "https://example.com/last.jpg"
    ]
  }'

提交响应

{
  "id": "task_xxx",
  "status": "queued",
  "model": "veo_3_1",
  "created_at": 1760000000
}

查询任务

curl https://cdn.12ai.org/v1/videos/task_xxx \
  -H "Authorization: Bearer $API_KEY"

响应结构

字段	类型	说明
`id`	string	任务 ID
`status`	string	`queued`、`processing`、`completed`、`failed`
`progress`	number	进度
`video_url`	string	完成后的视频 URL
`error`	object	失败原因

完成响应

{
  "id": "task_xxx",
  "status": "completed",
  "progress": 100,
  "video_url": "https://img.12ai.org/videos/task_xxx.mp4"
}

注意事项

场景	建议
文生视频	使用不带 `-fl` 的模型，不传图片
多图参考	使用不带 `-fl` 的模型，最多 3 张图
首尾帧	使用带 `-fl` 的模型，第一张为首帧，第二张为尾帧
更快返回	选择带 `fast` 的模型
更高画质	选择带 `hd` 的模型

Veo 视频生成

On this page