认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID。
值: veo_31_fast
prompt string 必需
视频的文字说明, 支持音频提示
negativePrompt string
描述视频中不应包含内容的文字
image object
用于添加动画效果的初始图片对象
lastFrame object
插值视频需要过渡到的最终图片对象
必须与 image 参数搭配使用
referenceImages array
最多 3 张图片, 用作风格和内容参考
类型：VideoGenerationReferenceImage[]
仅 Veo 3.1 系列支持
video object
用于视频扩展/附加场景的视频对象
类型：上一代产品的 Video 对象。
aspectRatio string
视频宽高比
可选值: 16:9, 9:16
默认值: 16:9
resolution string
视频分辨率
可选值: 720p, 1080p, 4k
当 durationSeconds 为 8 时才支持 1080p 和 4k。
720p 仅适用于扩展服务场景。
durationSeconds integer
生成视频时长（秒）
可选值: 4, 6, 8
使用扩展、参考图片、1080p 或 4k 时，必须为 8。
personGeneration string
控制人物生成策略
文生视频与扩展仅支持 allow_all
图生视频, 插帧与参考图流程仅支持 allow_adult
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息。状态为 failed 时存在。
code
integer错误码。
error_message
string详细错误消息。
output array
生成结果。状态为 completed 时存在。
content
array生成资源列表。
type
string资源类型。
值:
videourl
string输出地址。
jobId
string远端任务 ID。
usage object
使用统计信息。状态为 completed 时存在。
cost
string总费用（美元）。
discount
number折扣金额。
input_tokens
integer输入令牌数。
output_tokens
integer输出令牌数。
total_tokens
integer总令牌数。
metadata object
元数据信息。