Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证。获取 API Key:访问 API Key 管理页面 获取您的 API Key。使用时在请求头中添加:

请求参数

string
必填
视频生成模型名称,固定为 gemini-omni-flash-preview
string
必填
文本指令。文生视频为场景描述;图 / 视频生视频为动作 / 风格 / 编辑指令。
prompt 与参考素材(image_urls / video_urls至少提供其一
array<string>
参考图,最多 16 张。每项为 http(s):// URL。支持 JPEG / PNG。多主体(如「猫 + 毛线球」)可传多张,并在 prompt 中描述它们如何互动。
array<string>
参考 / 待编辑视频,最多 1 个(不支持多视频引用)。可为 http(s):// 直链或 data:video/...
  • 参考视频 1 ~ 24 秒,官方建议 ≤3 秒
  • video_urlsextend_from_task_id 互斥,二者只能提供其一,不能同时传入。
string
默认值:"16:9"
视频宽高比,真正控制输出画面方向。
传入 video_urls 后,aspect_ratio 参数失效。
仅支持:
  • 16:9 - 横屏(默认)
  • 9:16 - 竖屏
其它值按 16:9 处理。
string
默认值:"720p"
视频分辨率。当前仅支持 720p
string
上一个任务ID:填上一次生成任务的** task_id**。
extend_from_task_idvideo_urls 互斥,二者只能提供其一,不能同时传入。

响应

integer
响应状态码,成功时为 200
array
返回任务数组。

查询任务结果

视频生成为异步任务。提交后会返回 task_id,使用 获取任务状态 接口查询生成进度和结果。

成功结果示例

使用场景

场景 1:文生视频

场景 2:图生视频

场景 3:视频生视频