跳转到主要内容
POST

认证

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

请求参数

string
必填
视频生成模型名称,固定为 gemini-omni-1.2-flash-ext。
string
必填
视频内容描述或编辑指令,去除首尾空格后不能为空。文生视频描述场景、人物、动作、镜头和声音;带图片或视频时描述动作、风格或修改要求。示例:"Aerial shot over a misty mountain lake at sunrise."
所有模式都必须传入 prompt,包括首帧、多图参考、编辑和续写。缺少时返回 400 错误。
integer
默认值:"10"
视频时长,单位为秒,必须为整数。
  • 文生 / 首帧 / 多图参考:输出时长,支持 3–15
  • 首尾帧:输出时长,支持 3–10
  • 续写(extend):新增片段的时长,支持 3–10
  • 编辑(edit):不能传入,输出时长跟随源视频
也可使用别名 seconds,两者同时传入时必须相等。
编辑模式传入 duration 会返回 video edit does not accept duration 错误。
string
默认值:"720p"
视频分辨率,不区分大小写,决定每秒单价。可选值:
  • 360p
  • 720p
  • 1080p
  • 4k(也可传 2160p)
传入其他分辨率会返回 400 错误。
string
默认值:"16:9"
仅支持 16:9(横屏,默认)和 9:16(竖屏);其他值返回 400 错误。
string
任务类型,用于指定素材的使用方式。可选值:
  • edit - 编辑视频,需配合 video_urls 或 extend_from_task_id
  • extend - 续写视频,在片尾追加新内容,需配合 video_urls 或 extend_from_task_id
  • reference - 多图参考,需配合 image_urls
  • text_to_video / image_to_video / reference_to_video - 文生 / 首帧 / 参考图
  • auto - 按输入自动判断;带视频时视为 edit
不带视频时可不传,按输入自动判断。
传入 video_urls 或 extend_from_task_id 时必须传入任务类型(omni_reference_task_type,或兼容字段 generation_type),不传返回 400 错误。推荐显式传入 edit 或 extend;传 auto 时按 edit 处理。
string
兼容字段,与 omni_reference_task_type 等价。可选值:frame(等同 image_to_video)、reference、edit、extend。
generation_type 与 omni_reference_task_type 不可以同时传入。
array<url>
参考图片数组,用于多图参考(人物、商品、风格等),支持 1–10 张。仅支持公网可访问的 HTTP/HTTPS 图片 URL。本地图片请先上传获取公网 URL 再传入;当前不支持 Base64 Data URL,传入会返回 400 错误。只传 1 张图片时,处理方式取决于任务类型:
  • 不传 omni_reference_task_type:按参考图处理
  • omni_reference_task_type 为 auto 或 image_to_video:按首帧处理
首帧场景建议直接使用 first_frame_image,不要依赖图片数量区分。
image_urls 不能与 first_frame_image 或 last_frame_image 同时传入,image_urls 中的图片不会被当作首帧;编辑和续写时也不能传入图片。
string
首帧图片,生成视频的第一帧即为该图。仅支持公网可访问的 HTTP/HTTPS 图片 URL,不支持 Base64 Data URL。与 last_frame_image 同时传入时为首尾帧生视频。
string
尾帧图片,用于首尾帧生视频,视频从首帧画面过渡到该图。仅支持公网可访问的 HTTP/HTTPS 图片 URL,不支持 Base64 Data URL。首尾帧模式下:
  • duration 支持 3–10,不传按 10 秒
  • 不能传入 system_prompt 和 negative_prompt
last_frame_image 必须与 first_frame_image 同时传入,只传尾帧会返回 last_frame_image requires first_frame_image 错误;不能与 image_urls 同时传入。
array<object>
带角色的图片数组,是 first_frame_image / last_frame_image / image_urls 的等价写法。
array<url>
待编辑或续写的视频数组,仅支持 1 段视频。也可使用单值字段 video_url,二选一。只支持公网可访问的 HTTP/HTTPS 视频 URL,格式为 MP4 / MOV / WebM,时长不超过 15 秒,大小不超过 64 MB。
传入 video_urls 时必须同时传入任务类型,推荐 omni_reference_task_type 为 edit 或 extend(auto 按 edit 处理);不传返回 400 错误。传入 2 个及以上视频会返回 400 错误。
string
本平台的任务 ID(task_01…),基于自己之前已完成的 gemini-omni-1.2-flash-ext 任务继续编辑或续写,无需重新上传视频。使用条件:
  • 任务属于当前账号
  • 任务模型为 gemini-omni-1.2-flash-ext
  • 任务状态为 completed
  • 生成原任务的通道仍可用,否则返回 503 source_channel_unavailable
  • 原任务成片不超过 15 秒(编辑和续写均适用);编辑模式下还需时长可识别
通道不可用或原成片时长无法识别时,请下载原成片后改用 video_urls 上传;原成片超过 15 秒时,需先裁剪至 15 秒以内再上传。
extend_from_task_id 不能与 video_urls 同时传入,且必须同时传入任务类型,推荐 omni_reference_task_type 为 edit 或 extend(auto 按 edit 处理)。
string
不希望出现在画面中的内容。示例:"people, cars, color"
首尾帧模式不能传入 negative_prompt。
string
系统指令,例如固定画面风格、禁止出现文字。必须为字符串。示例:"Render as a black-and-white silent film."
首尾帧模式不能传入 system_prompt。

响应

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

查询任务结果

视频生成为异步任务。提交后会返回 task_id,使用 获取任务状态 接口查询生成进度和结果。
cURL
建议每 5-10 秒轮询一次,客户端超时设为 10 分钟以上。生成耗时参考(含排队):360p 15 秒约 46 秒,1080p 15 秒约 99 秒,4k 15 秒约 4-5 分钟。生成中进度可能长时间停留在 10%,直到完成。

成功结果示例

视频地址为 data.result.videos[0].url[0]。data.actual_time 为任务耗时(秒),不是视频时长。输出为 MP4(H.264,24fps),含 AAC 音轨和 SynthID 不可见水印;4k 偶发无音轨。

失败结果示例

任务失败时全额退款。

计费说明

按秒计费:费用 = 所选分辨率的每秒单价 × 计费秒数。所有模式均按请求的分辨率档位计费。实际单价以 价格页面 为准。

使用场景

场景 1:文生视频

场景 2:首帧生视频

场景 3:首尾帧生视频

首尾帧时 duration 支持 3–10 秒,不传按 10 秒;不能传入 system_prompt / negative_prompt。

场景 4:多图参考

场景 5:视频编辑

编辑时不传 duration,输出时长跟随源视频。

场景 6:视频续写

场景 7:基于已有任务续写

场景 8:系统指令与反向提示词