跳转到主要内容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "action": "generate",
    "prompt": "A golden retriever running on a beach at sunset, cinematic lighting, slow motion",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo-3.1",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
异步处理模式 — 提交请求后返回任务 ID，通过 查询任务状态 接口获取生成结果。视频链接有效期 24 小时，请及时下载。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "action": "generate",
    "prompt": "A golden retriever running on a beach at sunset, cinematic lighting, slow motion",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo-3.1",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
可用模型

模型 ID说明
veo-3.1VEO 3.1，支持 4K、原生音频
veo-3.1-fastVEO 3.1 快速版
veo-3.0VEO 3.0

​
统一参数

​
model
string
必填
模型 ID
​
action
string
默认值:"generate"
操作类型
​
prompt
string
必填
视频描述文本。VEO 3+ 支持在 prompt 中描述音效和对白，模型会自动生成对应音频
​
aspect_ratio
string
默认值:"16:9"
宽高比：16:9、9:16
​
duration
integer
默认值:"8"
视频时长（秒）：4、6、8
​
resolution
string
默认值:"720p"
输出分辨率，可选值取决于模型，见各模型 Tab
​
negative_prompt
string
不希望出现的内容，直接描述即可（不要用否定语句）
​
seed
integer
随机种子，提高可重复性（不保证完全一致）。仅 VEO 3.1 系列支持
​
callback_url
string
Webhook 回调地址
​
extra
object
透传给 Google VEO 的额外参数，详见各模型 Tab

​
模型特定参数

resolution 可选值： 720p、1080p、4k
​
extra.personGeneration
string
默认值:"allow_all"
人物生成控制：
  • allow_all — 允许所有人物
  • allow_adult — 仅允许成年人
  • dont_allow — 禁止人物生成
独有能力：
  • 原生音频生成（对白 + 环境音 + 音效，无需额外参数）
  • 4K 分辨率输出

​
约束条件

条件要求
分辨率 1080p 或 4kduration 必须为 8
分辨率 4k仅 VEO 3.1 和 3.1 Fast 支持
输出帧率24 FPS
输出格式MP4
VEO 3+ 原生支持音频生成，无需额外参数。在 prompt 中描述音效即可（如 “the sound of waves crashing”）。

​
响应

​
task_id
string
任务 ID
​
model
string
使用的模型 ID
​
action
string
操作类型
​
status
string
任务状态：queued
​
created_at
integer
创建时间（Unix 毫秒时间戳）
​
progress
integer
进度，初始为 0