Veo 3.1 参数与错误
本页描述 Veo 3.1 Standard 与 Fast 在统一异步接口 POST /v1/video/tasks 中的公开契约。当前只支持 generation。
能力矩阵
| 模型 | 时长 | 画幅 | frame | images |
|---|---|---|---|---|
adobe-veo-3.1-standard-720p | 4、6、8 秒 | 16:9、9:16 | 最多 2 图 | 最多 3 图；仅 8 秒 + 16:9 |
adobe-veo-3.1-standard-1080p | 4、6、8 秒 | 16:9、9:16 | 最多 2 图 | 最多 3 图；仅 8 秒 + 16:9 |
adobe-veo-3.1-fast-720p | 4、6、8 秒 | 16:9、9:16 | 最多 2 图 | 不支持 |
adobe-veo-3.1-fast-1080p | 4、6、8 秒 | 16:9、9:16 | 最多 2 图 | 不支持 |
output.duration 只接受离散值 4、6、8，不接受 5 或 7。分辨率由完整模型名固定，output.resolution 会被拒绝。
创建任务字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 完整 Veo 公开模型名 |
operation | string | 是 | 固定为 generation |
input.prompt | string | 是 | 非空视频提示词，最多 1200 个 Unicode 字符 |
input.reference_mode | string | 否 | frame，或 Standard 使用的 images；默认 frame |
input.image | object | 否 | 第一张图片；frame 中表示首帧 |
input.reference_images | array | 否 | 追加图片；frame 中第二张为尾帧 |
output.duration | integer | 是 | 4、6、8 |
output.aspect_ratio | string | 否 | 16:9 或 9:16，默认 16:9 |
output.generate_audio | boolean | 否 | 是否生成成片音轨，省略时默认 true |
client_reference_id | string | 否 | 调用方业务关联 ID，最长 191 字符 |
metadata | object | 否 | 随任务查询和 Webhook 原样返回 |
参考图
参考图对象：
{
"url": "https://media.example.com/reference.jpg",
"name": "product"
}只接受绝对 HTTP/HTTPS URL，不接受 Base64、Data URL、multipart 或内部文件 ID。本地图片先通过 /v1/media/uploads 直传到对象存储，再把确认得到的 URL 放入任务请求。
frame 图片顺序：
input.image：首帧。input.reference_images[0]：尾帧。
Standard images 使用 input.reference_images[]，最多三项；这些图片不具有首尾帧位置语义。
Veo 不支持 media、参考视频或参考音频。
Standard images 组合
以下请求片段是唯一受支持的 Standard 多图输出组合：
{
"input": {
"reference_mode": "images",
"reference_images": [
{"url": "https://media.example.com/one.jpg", "name": "one"},
{"url": "https://media.example.com/two.jpg", "name": "two"},
{"url": "https://media.example.com/three.jpg", "name": "three"}
]
},
"output": {
"duration": 8,
"aspect_ratio": "16:9"
}
}images + 4s、images + 6s 或 images + 9:16 都返回 400 invalid_video_parameter。
旧参数迁移
{
"input": {
"reference_mode": "frame"
},
"output": {
"generate_audio": true
}
}旧的 provider_options.*.generate_audio 和 provider_options.*.reference_mode 已停止兼容，必须分别改用 output.generate_audio 和 input.reference_mode。旧写法返回 400 invalid_provider_options。
不能通过 provider_options 覆盖模型、提示词、时长、画幅、分辨率或参考素材。未知命名空间、未知字段和错误类型返回 400 invalid_provider_options。
按秒计费
费用额度 = 每秒价格 × output.duration × 当前有效分组倍率- Standard/Fast、720p/1080p 是独立模型和价格绑定。
- 参考图数量和模式不改变计费秒数。
- 不叠加
resolution、size等倍率。 - 分组倍率来自 Token 所属分组或聚合分组。
- 是否可使用订阅余额以模型定价策略为准；未开启时只扣钱包。
- 参数校验失败发生在预扣前；异步失败按现有任务规则退款。
任务和结果
任务状态为 queued、in_progress、succeeded 或 failed。成功时 result.videos[] 包含：
| 字段 | 说明 |
|---|---|
asset_id | 资源管理中心资源 ID |
url | 视频访问地址 |
temporary | 是否应把 URL 视为临时资源 |
url_auth | none 或 resource_api_key |
duration_ms | 结果时长元数据；当前回显已验证的请求时长 |
结果为 temporary: true、url_auth: "none" 时，浏览器可以直接访问签名 HTTPS 地址；不要附加模型 Token 或资源 API Key。地址过期后不会自动刷新或恢复。
当前不会下载结果媒体重新探测时长。duration_ms 只用于展示和审计，不参与二次补扣或退款。
常见错误
| HTTP 状态或错误码 | 原因 | 处理方式 |
|---|---|---|
400 invalid_request | JSON 无效、duration 不是整数、参考图数量超限，或 frame/images 传了视频或音频 | 修正字段类型、JSON 和参考素材 |
400 video_duration_required | 缺少 output.duration | 传 4、6 或 8 |
400 invalid_video_duration | 传了 4/6/8 以外的值 | 改用支持的离散时长 |
400 invalid_video_aspect_ratio | 画幅不是 16:9 或 9:16 | 改用支持的画幅 |
400 unsupported_reference_mode | Fast 使用 images，或 Veo 使用 media | 按能力矩阵选择模式 |
400 invalid_video_parameter | 提示词超过 1200 个字符、Standard images 组合错误，或传了分辨率 | 缩短提示词，使用 8 秒 + 16:9，并移除分辨率 |
400 invalid_provider_options | 兼容参数命名空间、字段或类型无效 | 只使用公开选项 |
400 unsupported_video_operation | 使用 edit、extension 或 remix | 改为 generation |
400 unsupported_video_model | 模型未开放或模型映射错误 | 查询 /v1/models |
409 idempotency_key_conflict | 同一个幂等 Key 对应不同请求 | 使用新的 Key |
401 / 403 | Key 无效、停用或类型错误 | 创建使用 sk-...，查询使用 ak_... |
404 task_not_found | 任务不存在或不属于当前账号 | 核对任务 ID 和资源 Key |
不要重试参数类 400。终态任务失败时先读取 error.retryable；需要重建任务时使用新的 Idempotency-Key。