Veo 3.1 视频生成 API

使用 Google 模型 ID，通过 APIMaster 统一异步 API 提交视频生成任务、查询进度并下载视频。

• veo-3.1-generate-preview — Veo 3.1
• veo-3.1-fast-generate-preview — Veo 3.1 Fast
• veo-3.1-lite-generate-preview — Veo 3.1 Lite

模型能力

模型	时长	分辨率	音频	图片输入
Veo 3.1	4 / 6 / 8 秒	720p / 1080p / 4k	可开启或关闭	首帧、首尾帧
Veo 3.1 Fast	4 / 6 / 8 秒	720p / 1080p / 4k	可开启或关闭	首帧、首尾帧、参考图
Veo 3.1 Lite	固定 8 秒	720p / 1080p	必须开启	不支持，仅文生视频

1080p 和 4k 必须使用 8 秒。系统根据参数自动选择可用服务；部分高级能力的可用性取决于当前服务。每个任务只生成一个视频。

渠道限制（2026-10-27 核查）： 306（Ext）当前仅支持 8 秒输出。Standard/Fast 的 720p、4 秒或 6 秒请求需要 305 等兼容 Official 渠道。若在渠道偏好中排除此类渠道，即使公共模型支持该时长，也会找不到兼容路由。306 暂无已确认的 4/6 秒开放日期。

请求参数

使用 POST https://apimaster.ai/v1/videos，请求头为 Content-Type: application/json，并携带 Authorization: Bearer YOUR_API_KEY。兼容入口：POST https://apimaster.ai/v1/videos/generations。

参数	类型	必填	默认值	说明
model	string	是	—	上述三个完整模型 ID 之一
prompt	string	是	—	非空视频描述，可描述动作、镜头和声音
duration	integer	否	8	Standard / Fast：4、6、8；Lite：仅 8。1080p / 4k 必须为 8
resolution	string	否	720p	720p、1080p、4k；Lite 不支持 4k
aspect_ratio	string	否	16:9	16:9 横屏或 9:16 竖屏；参考图模式只能用 16:9
generate_audio	boolean	否	true	false 生成无声视频；Lite 只能为 true
image_urls	string[]	否	—	Standard / Fast：1 张首帧或 2 张首尾帧；Fast 参考图模式支持 1–3 张。必须是公开可访问的 HTTP(S) 图片 URL；Lite 不支持
generation_type	string	否	自动	frame：首帧/首尾帧；reference：仅 Fast，须有图片且比例为 16:9。传 3 张图片时自动使用参考图模式；Lite 不支持
sample_count	integer	否	1	仅支持 1，每个任务生成一个视频

参考图模式（generation_type: "reference"）还须使用 duration: 8、generate_audio: true，且不能同时传入下表的高级参数。

高级参数

以下参数仅用于 Standard / Fast，并由系统选择兼容服务。Lite 不接受这些参数，即使传空值也应移除。

参数	类型	取值与说明
negative_prompt	string	不希望出现的内容；可省略
seed	integer	0–4294967295；0 是有效值，不保证跨请求完全复现
person_generation	string	allow_adult 或 disallow：人物生成策略
resize_mode	string	pad 或 crop：图片适配方式
enhance_prompt	boolean	如需传入，只支持 true；不支持 false

兼容参数

优先使用上表的标准字段。不要传入相互冲突的别名值。

参数	类型	说明
seconds	integer	duration 的别名，同时传入时数值必须一致
ratio	string	aspect_ratio 的别名，同时传入时必须一致
size	string	可用 720p、1080p、4k，或 1280x720、720x1280、1920x1080、1080x1920；须与分辨率和画幅一致
input_reference / first_frame_image	string	首帧图片 URL；二选一，不与 image_urls 混用；Lite 不支持
last_frame_image	string	尾帧图片 URL，须同时提供恰好一张首帧；Lite 不支持
metadata	object	可包装本页已支持的参数；不能包含 model、嵌套 metadata 或与顶层冲突的值
nsfw_check	boolean	省略或 false；不支持 true

提交示例

{"model":"veo-3.1-generate-preview","prompt":"A paper boat drifting across a quiet lake at sunrise, natural ambient sound","duration":8,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}

{"model":"veo-3.1-lite-generate-preview","prompt":"A paper boat on a sunlit lake","duration":8,"resolution":"720p","generate_audio":true}

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-generate-preview","prompt":"A paper boat drifting across a quiet lake at sunrise","duration":8,"resolution":"720p","generate_audio":true}'

POST https://apimaster.ai/v1/videos → {"id":"task_...","task_id":"task_...","status":"queued"}

提交返回 id 只表示已受理。每 5–10 秒查询一次，等待 completed；failed 表示生成失败。完成后携带同一个 API Key 下载视频并及时保存。

curl "https://apimaster.ai/v1/videos/task_..." -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_.../content" -H "Authorization: Bearer YOUR_API_KEY" -o video.mp4

queued → in_progress → completed / failed

计费与退款

下表为 Google 官方基础价（USD/秒），不是统一成交价。实际扣费以模型广场、账号价格规则及消费日志为准。续写按一次新的 8 秒计价单位收费，不按包含原视频的总长度重复计费。失败任务退回生成预扣费用。

Google model	720p + audio	1080p + audio	4K + audio	720p silent	1080p silent	4K silent
veo-3.1-generate-preview	$0.40/s	$0.40/s	$0.60/s	$0.20/s	$0.20/s	$0.40/s
veo-3.1-fast-generate-preview	$0.10/s	$0.12/s	$0.30/s	$0.08/s	$0.10/s	$0.25/s
veo-3.1-lite-generate-preview	$0.05/s	$0.08/s	—	—	—	—

Google Gemini API · Google Cloud

视频续写

当前仅 Standard（veo-3.1-generate-preview）的兼容已完成任务支持续写，并非所有 Standard 任务都可续写。Fast 和 Lite 暂不支持续写。请使用原任务所属账号的 API Key；系统自动使用原任务的模型和服务。原任务不兼容时无法通过切换服务续写。

使用 POST https://apimaster.ai/v1/videos/{id}/remix，其中 {id} 为原任务 ID。返回新的任务 ID，按相同流程查询并下载。

参数	类型	必填	说明
model	string	是	veo-3.1-generate-preview，须与原任务一致
prompt	string	是	非空续写场景描述
raw	boolean	否	true 仅返回续写片段；false 返回拼接视频；示例显式设为 false
resolution	string	否	720p（默认）、1080p 或 4k
aspect_ratio	string	否	16:9（默认）或 9:16

续写不接受图片输入。参数错误通常返回 400；所选服务不支持所请求能力时可返回 503。查询任务的 failed 状态和错误信息，不要将提交成功误认为生成成功。

curl "https://apimaster.ai/v1/videos/task_.../remix" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-generate-preview","prompt":"The paper boat continues past green reeds","raw":false,"resolution":"720p","aspect_ratio":"16:9"}'