查询结果
GET /v1/video/query
Omni-Flash · 查询任务(GET /v1/video/query,VEO relay 物理路由,主文档见 relay/veo)。
查询 POST /v1/video/create 创建的 Omni-Flash 视频任务状态与结果;status=failed 时 error 给出失败原因。
请求参数 (Query / Path)
string
路径中的资源 / 任务 ID
string
模型名
请求示例 (cURL)
响应示例 (200 OK)
google-omni-flash(下载视频(Google Files))
GET /v1beta/files/{example-file-id}:download
请求参数 (Query / Path)
string
required
文件 ID
请求示例 (cURL)
响应示例 (200 OK)
google-omni-flash(查询文件状态)
GET /v1beta/files/{example-file-id}
请求参数 (Query / Path)
string
required
文件 ID
请求示例 (cURL)
响应示例 (200 OK)
google-omni-flash(下载视频(GCS))
GET /v1beta/files/gcs
请求示例 (cURL)
响应示例 (200 OK)
google-omni-flash(查询交互)
GET /v1beta/interactions/{interaction_id}
请求参数 (Query / Path)
string
required
交互 ID
请求示例 (cURL)
响应示例 (200 OK)
Omni-Flash 视频生成
POST /v1/video/create
Omni-Flash · 统一视频创建(POST /v1/video/create,VEO relay 物理路由,主文档见 relay/veo)。
按 model=omni-flash / omni-flash-edit 走 Omni-Flash 链路;type 决定具体能力:
1=文生视频(仅需prompt)2=首尾帧(images需 1~2 张)3=垫图参考(images需 1~3 张)4=Omni-Flash 视频编辑(需input_reference)
id(任务 ID),轮询 GET /v1/video/query?id= 获取结果。
请求参数 (Query / Path)
string
请求体数据格式
string
客户端期望接收的响应数据格式
string
API 认证密钥,格式为 Bearer + 空格 + 你的 API Key
请求体参数 (Body)
string
画幅比例
boolean
Omni-Flash 系列切换 1080p(4K 模型忽略)
boolean
升级到 1080p(部分 4K 模型有效)
array
图片 URL 数组(type=2 需 1-2 张,type=3 需 1-3 张)
string
Omni-Flash edit 参考视频(JSON 场景传 URL 或 dataURI)
string
required
模型名称(示例:omni-flash、omni-flash-edit)
string
required
视频内容描述
string
视频时长(秒),示例:“8”
string
自定义尺寸,宽比高长为16:9,高比宽长为9:16,aspect_ratio生效时,该参数无效
integer
生成类型:1=文生视频, 2=首尾帧, 3=垫图参考, 4=Omni-Flash 视频编辑
请求示例 (JSON)
请求示例 (cURL)
响应示例 (200 OK)
google-omni-flash(异步·文生视频)
POST /v1beta/interactions
请求体参数 (Body)
boolean
required
省略或 false 为同步;建议客户端超时 ≥600s
object
生成配置对象
string
required
文生视频提示词
string
required
模型名称 / 型号 ID
object
响应格式约束
boolean
是否保存 Interaction;异步下不可为 false
boolean
不支持 true,请省略或 false