使用说明和示例
概述
| 项目 | 说明 |
|---|---|
| 基础路径 | {BASE_URL}/v1/videos |
| 鉴权 | Authorization: Bearer {API_TOKEN} |
| 创建任务 | POST /v1/videos |
| 查询任务 | GET /v1/videos/{task_id} |
| 下载视频 | GET /v1/videos/{task_id}/content |
veo-3.0-generate-001veo-3.0-fast-generate-001veo-3.1-generate-previewveo-3.1-fast-generate-preview图片输入能力对照
| 能力 | Google 官方 Veo 能力 | 当前本站接口支持情况 | 说明 |
|---|---|---|---|
| 单张初始图生成视频 | 支持 | 支持 | 使用 input_reference 上传 1 张图片，作为视频起始画面。 |
| 首尾帧生成 / 插帧 | Veo 3.1 系列支持 image + lastFrame | 支持 | 使用 input_reference 上传首帧，使用 last_frame 或 lastFrame 上传尾帧。建议使用 Veo 3.1 系列、8 秒。 |
| 多张参考图 | Veo 3.1 系列支持最多 3 张 referenceImages | 支持 | 使用 reference_image、reference_images 或 referenceImages 上传，referenceType 仅支持 asset。建议使用 8 秒。 |
| 视频扩展 | Veo 3.1 / Veo 3.1 Fast 支持扩展已有 Veo 视频 | 暂不支持 | 当前本站接口没有开放官方 video 输入。 |
图片 MIME 类型支持 image/jpeg、image/png、image/webp。推荐传文件或 Base64，不建议直接传远程图片 URL。
通用参数说明
JSON 请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 如 veo-3.1-generate-preview |
prompt | string | 是 | 视频描述 / 运镜提示 |
duration | int | 否 | 时长（秒），如 8 |
size | string | 否 | 如 1280x720，会映射为分辨率与宽高比 |
metadata | object | 否 | 见下表 |
metadata 常用字段
| 字段 | 说明 |
|---|---|
negativePrompt | 负向提示（参考图任务请勿传） |
resolution | 如 720p、1080p |
aspectRatio | 如 16:9、9:16 |
seed | 随机种子 |
referenceImages | 参考图数组（JSON/Base64 方式） |
lastFrame / last_frame | 尾帧（JSON/Base64 方式） |
image | 首帧（JSON/Base64 方式） |
multipart/form-data 表单字段
| 字段 | 说明 |
|---|---|
model | 模型名 |
prompt | 提示词 |
input_reference | 首帧图片（文件，图生视频必填字段名） |
last_frame / lastFrame | 尾帧图片（文件） |
reference_image / reference_images / referenceImages | 参考图（可多张，最多 3 张） |
reference_type / referenceType | 仅支持 asset |
seconds / duration | 时长（秒） |
size | 如 1280x720 |
resolution | 如 720p |
aspectRatio | 如 16:9 |
negativePrompt | 负向提示 |
seed | 随机种子 |
创建文生视频任务
典型返回：
{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"object": "video",
"model": "veo-3.1-generate-preview",
"status": "queued",
"progress": 0,
"created_at": 1775025000
}创建首帧图生视频任务
multipart/form-data，首帧图片字段名必须是 input_reference。创建首尾帧任务
input_reference，尾帧用 last_frame 或 lastFrame。需使用 Veo 3.1 系列模型；仅传尾帧不传首帧会报错。
创建参考图任务
referenceType 仅支持 asset。字段名可用 reference_image、reference_images 或 referenceImages。注意： 参考图任务不要传 negativePrompt。
查询任务状态
{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"object": "video",
"model": "veo-3.1-generate-preview",
"status": "completed",
"progress": 100,
"created_at": 1775025000,
"completed_at": 1775025600,
"metadata": {
"url": "https://..."
}
}下载视频内容
注意事项
1.
2.
3.
4.
5.
6.
修改于 2026-05-25 10:32:25