Google

Gemini Omni 1.2

gemini-omni-1.2-flash

Google 的视频生成模型，支持文生视频、图生视频与参考图生视频，最多可上传 10 张参考图，也能用首帧或首尾帧指定画面起点与落点，适合产品展示视频与社媒广告素材制作

gemini-omni-1.2-flash

试用 gemini-omni-1.2-flash

输入

作品灵感

查看全部作品

输出

video

填写参数并生成，结果会显示在这里。

价格

gemini-omni-1.2-flash 每秒

规格	单价
360P	$0.0229
720P	$0.0343
1080P	$0.0343
4K	$0.080

定位简介

这是一款面向开发者的视频生成模型，可根据文本描述、参考图片或首尾帧画面产出短视频片段，单次时长为3至15秒，使用首尾帧模式时最长10秒。可用一张公开图片作为参考内容或风格，也可用首帧指定开场画面；参考图输入与帧输入互斥。它适合需要批量产出横版或竖版短视频素材的电商、投放与创意团队。

核心亮点

参考图与首尾帧两种控制方式——最多10张公开图片可作角色、产品或风格参考；也可用首帧和尾帧指定起止画面。
按投放渠道选择画幅与分辨率——画幅支持16:9横版或9:16竖版，分辨率可在360p、720p、1080p、4k中选择。
提示词可描述场景与运镜——提示词必填且最多20000字符，可说明画面内容、运动和镜头推进方式。

能力说明

文生视频与参考图生视频：只给提示词即可生成视频；image_urls接收1至10张公开HTTP(S)图片，仅一张图时也按参考图处理，用于约束人物、产品或风格。

首帧与首尾帧过渡：first_frame_url单独指定开场画面；同时给first_frame_url和last_frame_url可按起止画面生成过渡镜头，此时时长上限为10秒，且不能同时使用参考图。

时长、画幅与分辨率设置：duration为3至15的整数秒，默认10秒；aspect_ratio可选16:9或9:16；resolution可选360p、720p、1080p、4k，默认720p。

整体风格与排除内容：system_prompt用于设定整体视觉风格，negative_prompt用于描述要排除的内容；指定尾帧时这两项均不可用。

适用场景

电商团队制作商品展示短片——以提示词和多张商品或人物参考图生成横版短片，用作详情页与商品卡位的展示素材。
投放团队产出竖版广告素材——用提示词描述卖点并选9:16画幅，生成适合信息流与短视频平台竖屏投放的视频。
设计团队把静态画面转为动态——把一张公开图片指定为首帧，生成从该画面展开的运动片段，用于海报或插画动态化。
创意团队预演镜头起止——提供首帧与尾帧生成过渡镜头，用于分镜预演和概念片段的快速呈现。

限制与选型建议

单条视频时长限制在3至15秒，首尾帧模式最长10秒，需要更长内容须分段处理。1080p和4k为放大输出，4k可能不含音轨。参考图与首帧、尾帧互斥；指定尾帧后不能使用system_prompt和negative_prompt。所有图片参数仅接受公开HTTP(S) URL，不支持Base64。

近期更新

查看更新日志 →

模型上新 Gemini Omni 1.2 Flash 上线：文生视频、首帧与参考图生成

提交生成任务

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

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：gemini-omni-1.2-flash

routestring可选

当前固定值：default

inputobject必填

gemini-omni-1.2-flash 和线路 default 的业务参数对象，见下方参数表。

promptstring必填minLength 1maxLength 20000pattern \S

提示词，用于描述场景、运动、镜头与期望的声音；最多支持 20,000 个字符，任何模式下都必须提供非空白内容的提示词。

durationinteger可选默认值: 10min 3max 15

输出视频时长，取 3 到 15 之间的整数秒；使用首尾帧插值时最长限制为 10 秒。默认 10 秒。

image_urlsarray可选minItems 1maxItems 10

参考图数组，元素为图片 URL，可用 1 到 10 张作为角色、产品或风格参考；通过此参数传入一张图仍属于参考图模式，若希望以单张图片作为起始画面，请改用 first_frame_url。仅支持公网可直连的 HTTP(S) 图片地址，不支持 Base64；不能与首帧或尾帧同时使用。

Array [ string ]

resolutionstring可选默认值: "720p"

输出分辨率；1080p 与 4k 为放大输出，4k 输出可能不带音轨。默认 720p。

可选项：360p720p1080p4k

aspect_ratiostring可选默认值: "16:9"

输出画面比例，决定横屏或竖屏构图。默认 16:9。

可选项：16:99:16

system_promptstring可选

系统提示词，用于设定整体风格或视觉方向；不能与尾帧同时使用。

last_frame_urlstring可选minLength 1pattern ^https?://

尾帧图片地址，需与 first_frame_url 一起提供，此时时长上限为 10 秒；仅支持公网可直连的 HTTP(S) 图片地址，不支持 Base64；不能与参考图、system_prompt 或 negative_prompt 同时使用。

first_frame_urlstring可选minLength 1pattern ^https?://

视频首帧图片地址，可单独指定起始画面；需使用公网可直连的 HTTP(S) 图片 URL，不支持 Base64，且不能与 image_urls 同时使用；当提供 last_frame_url 时必填。

negative_promptstring可选

负向提示词，用于描述需要排除的内容；不能与尾帧同时使用。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-omni-1.2-flash",
  "input": {
    "prompt": "…",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gemini-omni-1.2-flash",
    input: {
      "prompt": "…",
      "duration": 10,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gemini-omni-1.2-flash",
        "input": {
          "prompt": "…",
          "duration": 10,
          "resolution": "720p",
          "aspect_ratio": "16:9"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}