跳转到内容
中文

Gemini Omni 1.1 Flash 视频生成 API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用,区别只在 input 字段(见下方 input 参数)。

模型概览

模型 gemini-omni-1.1-flash
输入模式 文字与多模态素材
时长 4 / 6 / 8 / 10 秒
分辨率 360p / 720p / 1080p / 4K

通过一个统一模型 ID 生成视频,支持文字、图片和参考视频输入。

生产建议

调用建议
  • 创建任务后从 data.taskId 读取任务 ID。
  • 等待回调或轮询 GET /v1/tasks/:id;成功后读取 output[].url。

适用场景

普通视频生成

同一个模型 ID 支持文字、图片和参考视频输入。

promptimage_urlsvideo_list

请求参数

model string 必填

固定模型 ID。

示例 gemini-omni-1.1-flash
input object 必填

根据创作模式选择文字或多模态输入。

prompt string 必填

描述场景、动作、镜头和声音,长度 1–20,000 个字符。

image_urls string[] 可选

可选图片 URL,最多 7 张;可用于输入图片或参考图片。

first_frame_url string 可选

可选首帧图片 URL;使用首帧时不要同时传入 image_urls 或 video_list。

last_frame_url string 可选

可选尾帧图片 URL,需要同时提供首帧。

video_list object[] 可选

可选视频输入,最多 1 个;视频会影响输出时长。

url string 必填

可公开访问的视频 URL。

start number 可选

起始时间,单位为秒。

默认 0
ends number 可选

结束时间,单位为秒。

duration string 可选

输出视频时长,单位为秒;视频输入时由模型决定。

默认 8 可选值: 46810
aspect_ratio enum 可选

输出视频宽高比。

默认 16:9 可选值: 16:99:16
resolution enum 可选

输出视频分辨率。

默认 720p 可选值: 360p720p1080p4k
seed integer 可选

可选随机种子,范围 0–2147483647。

callback object 可选

任务进入终态时接收通知。

url string 必填

接收通知的 HTTPS 地址。

when enum 可选

任务终态时触发。

默认 final 可选值: final

用例示例

参考视频示例

使用目标模型生成的永久参考视频作为输入,完成风格与运动转换。

请求体
{
  "model": "gemini-omni-1.1-flash",
  "input": {
    "prompt": "一个连续镜头:金色日出照亮平静海面,镜头缓慢推进,环境声音自然。",
    "video_list": [
      {
        "url": "https://static.hiapi.ai/admin-assets/gemini-omni-1-1-flash/2026/09/02/1788359834997-73681ce500c88b7c-gemini-omni-1-1-flash-golden.mp4",
        "start": 0,
        "ends": 8
      }
    ],
    "duration": "8",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }
}
图片参考示例

将可公开访问的图片 URL 放入 image_urls。

请求体
{
  "model": "gemini-omni-1.1-flash",
  "input": {
    "prompt": "让参考图中的主体缓慢移动。",
    "image_urls": [
      "https://static.hiapi.ai/admin-assets/2026/08/29/1787978094949-d75ee2d6c7d1000d-i2v-watch.png"
    ],
    "duration": "4",
    "aspect_ratio": "16:9",
    "resolution": "360p"
  }
}

获取结果

  1. 从创建响应的 data.taskId 读取任务 ID。
  2. 等待 callback 或轮询 GET /v1/tasks/:id。
  3. status=success 时读取 output[].url。

常见问题

这是几个模型?

HiAPI 对外只提供 gemini-omni-1.1-flash 一个模型 ID;输入字段决定创作模式。

如何获取结果?

使用 callback,或轮询 GET /v1/tasks/:id。

下一步