认证
authorization string 必需
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头中:
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: veo_3.1_generate_001
prompt string 必需
视频生成提示词, 长度必须在 1-2000 个字符之间
durationSeconds integer 必需
视频时长（秒）. 必须是 4, 6 或 8
注意: 参考图片转视频仅支持 8 秒
可选值: 4, 6, 8
默认值: 8
generateAudio boolean 必需
是否为视频生成音频. Veo 3 模型必需具有此参数
注意: veo-2.0-generate-001 或 veo-2.0-generate-exp 不支持 generateAudio
aspectRatio string
视频宽高比
注意: 参考图片转视频不支持 9:16
可选值: 9:16, 16:9
默认值: 16:9
resolution string
视频分辨率. 仅限 Veo 3 模型
注意: 视频扩展广告不支持 1080p
可选值: 720p, 1080p
默认值: 720p
compressionQuality string
压缩质量
可选值: optimized, lossless
默认值: optimized
personGeneration string
人物生成设置, 用于控制是否允许人物或人脸生成
可选值:
allow_adult: 仅允许生成成人（默认值）dont_allow: 禁止在图片中包含人物/人脸
默认值: allow_adult
sampleCount integer
生成样本数, 请求的输出视频数量
范围: 1 - 4
默认值: 1
seed integer
随机种子, 以使生成的视频具有确定性. 在请求中添加种子编号而不更改其他参数会导致模型生成相同的视频
范围: 0 - 4294967295
negativePrompt string
负面提示词, 用于描述您想要阻止模型生成的内容
image string
首帧图像, URL
lastFrame string
最后一帧图像, URL
video string
输入视频, URL 或 Base64 编码
referenceImages array
参考图像列表, 最多 3 个
注意:
Veo 3.1 模型不支持 referenceImages.style. 如要使用风格图片, 请使用 veo-2.0-generate-exp
以下模型支持 referenceImages: veo-2.0-generate-exp (Preview), veo-3.1-generate-preview (Preview)
image
string参考图像, URL 或 Base64 编码
referenceType
string参考类型
值:
asset
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息. 仅在状态为 failed 时存在
code
integer错误码
error_message
string详细错误消息
output array
生成结果. 仅在状态为 completed 时存在
content
array生成内容列表
type
string资源类型
值:
videourl
string内容 URL
jobId
string作业 ID
usage object
使用统计信息. 仅在状态为 completed 时存在
cost
string总费用（美元）
discount
number折扣金额
input_tokens
integer输入令牌数
output_tokens
integer输出令牌数
total_tokens
integer总令牌数
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 005002095 | 内部生成错误 |
| 005002096 | 结果解析异常 |
| 005002097 | HTTP 错误响应 |
| 005002098 | 状态检查异常 |
| 005002099 | 任务创建异常/服务不可用 |