跳转到主要内容
POST
/
v1
/
tasks
Veo 系列
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo3.1-quality-official",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

Google Veo 3.1 视频生成模型,提供 官方直连 与 逆向接入 两种渠道,共 4 个子档。
  • 官方档(Vertex AI 直连):按 秒 计费,支持 4 / 6 / 8 秒时长,720P / 1080P / 4K 三种分辨率。
  • 逆向档:按 次 计费(单次固定价),仅支持 8 秒 固定时长。
档位渠道计费方式定位
veo3.1-quality-official官方直连按秒旗舰档,最终交付质量
veo3.1-fast-official官方直连按秒加速档,适合迭代试稿
veo3.1-quality逆向接入按次逆向旗舰子型,固定 8 秒
veo3.1-lite逆向接入按次逆向轻量子型,固定 8 秒
两种渠道均原生支持音频、首尾帧关键帧、Remix 续写。

​
定价

4K 分辨率不支持静音,必须设 generate_audio=true(720p / 1080p 可静音也可有声)。下表中 720p_sound / 1080p_sound 为带音频加价档,4k_sound 是 4K 唯一档。

​
官方档(按秒)

720P 与 1080P 同价(Google 官方阶梯定价),开启 generate_audio=true 后单价翻倍。

​
veo3.1-fast-official

规格单价(每秒)8 秒视频
720P 静音$0.08$0.64
1080P 静音$0.08$0.64
720P + 音频$0.12$0.96
1080P + 音频$0.12$0.96
4K + 音频$0.28$2.24

​
veo3.1-quality-official

规格单价(每秒)8 秒视频
720P 静音$0.16$1.28
1080P 静音$0.16$1.28
720P + 音频$0.32$2.56
1080P + 音频$0.32$2.56
4K + 音频$0.48$3.84

​
逆向档(按次)

逆向档为单次固定价,与时长、分辨率、是否带音频无关(仅支持 8 秒)。具体价格以 admin 面板 / 控制台公示为准。
模型 ID计费方式时长单次价
veo3.1-quality按次8 秒(固定)TBD(参考控制台)
veo3.1-lite按次8 秒(固定)TBD(参考控制台)

​
调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1-fast-official",
    "prompt": "雨夜霓虹街道,一辆红色跑车驶过水洼,电影感慢镜头",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo3.1-quality-official",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
提交后用 GET /v1/tasks/{task_id} 轮询状态,详见 任务系统。

​
可用模型

模型 ID渠道档位计费时长分辨率
veo3.1-quality-official官方直连Quality 旗舰档按秒4 / 6 / 8 秒720P / 1080P / 4K
veo3.1-fast-official官方直连Fast 加速档按秒4 / 6 / 8 秒720P / 1080P / 4K
veo3.1-quality逆向接入Quality 旗舰子型按次8 秒(固定)720P / 1080P
veo3.1-lite逆向接入Lite 轻量子型按次8 秒(固定)720P / 1080P

​
通用参数

​
model
string
必填
模型 ID,可选 veo3.1-quality-official / veo3.1-fast-official / veo3.1-quality / veo3.1-lite
​
action
string
默认值:"generate"
操作类型,可选值:
  • generate — 文生视频(T2V)
  • image2video — 图生视频(I2V),需配合 first_frame_image
  • first_last_frame — 首尾帧关键帧,需同时传 first_frame_image 与 last_frame_image
  • remix — 基于已有片段续写
​
prompt
string
必填
视频描述文本,所有 action 必填
​
aspect_ratio
string
默认值:"16:9"
画面宽高比,可选值:
  • 16:9 — 横版宽屏
  • 9:16 — 竖版长屏
​
resolution
string
默认值:"1080p"
输出分辨率,可选值:
  • 720p
  • 1080p
  • 4k — 仅官方档支持,且必须 generate_audio=true(4K 不支持静音)
​
duration
integer
默认值:"8"
视频时长(秒):
  • 官方档:可选 4 / 6 / 8
  • 逆向档:仅 8(固定)
​
image_urls
string[]
通用图像引用数组(部分场景下与 first_frame_image 等价)
​
first_frame_image
string
视频首帧图 URL。image2video / first_last_frame / remix 模式必填
​
last_frame_image
string
视频尾帧图 URL,仅 first_last_frame 模式必填
​
callback_url
string
Webhook 回调地址,任务终态时调用。详见 回调机制
​
callback_events
string[]
订阅的回调事件类型,默认订阅终态(completed / failed)

​
模型特定参数

4 个子档参数完全一致,仅渠道、计费方式、可选时长 / 分辨率有差。Tab 顺序为 Quality 在前 / Fast / Lite 在后,官方在前 / 逆向在后。
​
generate_audio
boolean
默认值:"false"
是否生成音频轨道。开启后单价翻倍;4K 必须 true
​
sample_count
integer
默认值:"1"
生成样本数,范围 1-4
​
resize_mode
string
默认值:"pad"
图生视频时图片缩放策略,可选值:
  • pad — 边缘填充,保留完整画面
  • crop — 居中裁剪,贴合输出比例
​
enhance_prompt
boolean
默认值:"true"
上游提示词增强,只能为 true(Vertex AI 强制开启)
​
person_generation
string
默认值:"allow_adult"
人物生成策略,可选值:
  • allow_adult — 允许生成成年人物
  • disallow — 禁止生成人物
​
raw
boolean
默认值:"false"
Remix 模式专用,true 时仅返回延长部分,不拼接原片段

​
资源限制

项目限制
参考图片JPG / PNG / WEBP,单张 ≤ 20MB,建议 ≥ 720P
输出视频MP4,链接 24 小时有效
时长官方档 4 / 6 / 8 秒;逆向档仅 8 秒(固定)
分辨率720P / 1080P 任意;4K 仅官方档且必须 generate_audio=true
音频原生生成,无需额外 TTS;4K 必须有音频,720P / 1080P 音频可选
人物受 person_generation 策略约束,违规内容会被上游拦截

​
相关文档