Gemini Omni 1.2 Flash

本页说明本站网关实际支持的调用方式。

接口

POST /videos/generations

完整 URL: https://modelfold.ai/v1/videos/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

生成任务的输入参数。一次请求只使用一种生成模式：文生 / 参考图、只传首帧、首尾帧，或视频编辑。

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	用于生成任务的模型名称。该字段为必填项。此接口必须使用 google/gemini-omni-flash-1-2 模型。 默认值："google/gemini-omni-flash-1-2"。 可选值：google/gemini-omni-flash-1-2。 示例：google/gemini-omni-flash-1-2。
prompt	string	是	本站网关要求传入 prompt，最长 20000 字。视频提示词，必填，不能为空。用于描述场景、动作、镜头语言和声音。 minLength: 1. maxLength: 20000. 示例：一只猫在爵士酒吧弹钢琴，一镜到底，现场爵士乐轻柔响起。。
image_urls	array<string>	否	参考图地址，最多 6 张。用于提供人物、场景、风格或分镜参考。两张参考图不会被当作首尾帧。 限制： - 请使用可公开访问的图片 URL - 单张大小不超过 20MB - 与 first_frame_url、last_frame_url 互斥 maxItems: 6.
first_frame_url	string	否	首帧图片地址，用于指定生成视频的起始画面。请使用可公开访问的图片 URL。 - 只传首帧（不传尾帧）：duration 必填，整数 3–15 - 同时传 last_frame_url：duration 必填，整数 3–10 - 传入本字段时，不要传 image_urls、video_list - 不能只传 last_frame_url 示例：https://example.com/first.png。
last_frame_url	string	否	尾帧图片地址，用于指定生成视频的结束画面。必须同时传入 first_frame_url，不能单独使用。此时 duration 必填，取值 3–10。传入首尾帧时，不要传 image_urls、video_list。 示例：https://example.com/last.png。
video_list	array<string>	否	视频地址数组，最多 1 条。传入后为视频编辑模式，不要再传 duration，输出时长由输入视频决定。可同时传入 image_urls。与 first_frame_url、last_frame_url 互斥。请使用可公开访问的视频 URL，建议 MP4，不超过 15 秒。 maxItems: 1.
duration	integer	否	生成视频的时长，单位为秒，传整数。 - 文生 / 参考图（不传首帧、不传视频）：必填，取值 3–15 - 只传首帧：必填，取值 3–15 - 首尾帧：必填，取值 3–10 - 视频编辑（传入 video_list）：不要传，输出时长由输入视频决定 本站最短 3 秒，不支持 -1。 minimum: 3. maximum: 15. 示例：8。
aspect_ratio	string	否	生成视频的画面宽高比。可选值：16:9、9:16、auto。默认 16:9。无参考图时，auto 按 16:9 处理。 默认值："16:9"。 可选值：16:9 / 9:16 / auto。 示例：16:9。
resolution	string	否	生成视频的分辨率。可选值：360p、720p、1080p、4k。默认 720p。 默认值："720p"。 可选值：360p / 720p / 1080p / 4k。 示例：720p。
seeds	integer	否	随机种子。取值范围：10000–99999，传单个整数。不传时由系统自动生成。 minimum: 10000. maximum: 99999. 示例：12345。

请求示例

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/gemini-omni-flash-1-2",
  "prompt": "一只猫在爵士酒吧弹钢琴，一镜到底，现场爵士乐轻柔响起。",
  "aspect_ratio": "16:9",
  "resolution": "360p",
  "duration": 3
}'

{
  "model": "google/gemini-omni-flash-1-2",
  "prompt": "一只猫在爵士酒吧弹钢琴，一镜到底，现场爵士乐轻柔响起。",
  "aspect_ratio": "16:9",
  "resolution": "360p",
  "duration": 3
}

响应

200 — 生成完成。usage 返回请求用量；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}