跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Kling 3.0 Omni Image-to-Video API

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

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

模型概览

模型名称 kling-3.0-omni/image-to-video
类型 视频生成（图生视频）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Kling 3.0 Omni（可灵 O3）图生视频：以 1 张首帧或首尾 2 张图片生成 3–15 秒、720p 至 4k 的视频，画幅跟随首帧，支持原生同步音频、智能分镜与 @名称 主体素材。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

静图动画化

以已有图片为首帧，加入主体运动、镜头推拉与环境氛围。

image_urlsprompt
首尾帧过渡

传两张图片指定首帧与尾帧，让模型生成两者之间的自然过渡。

image_urlsduration
音画同步短片

开启 audio，一次生成带环境声与音效的视频。

audio
角色一致

用 elements 补充同一主体的多张图片，在提示词中以 @名称 引用。

elements

请求参数

model string 必填

固定填 kling-3.0-omni/image-to-video。

示例 kling-3.0-omni/image-to-video
input object 必填

业务参数对象；可灵 Kling 3.0 Omni 图生视频的模型专属配置都放在这里。

prompt string 必填

描述想要的画面内容、主体动作与镜头运动；需要用到 elements 里的主体时，在提示词中以 @名称 引用。长度 1–3072 字符。

image_urls string[] 必填

帧图片：传 1 张作为首帧，传 2 张则依次为首帧和尾帧。JPG/PNG，单张不超过 50MB，最短边不小于 300px，宽高比 0.4–2.5；输出视频的画幅跟随首帧。

duration integer 可选

视频时长，单位为秒，取 3–15 之间的整数。

默认 5
resolution enum 可选

输出视频分辨率。

默认 720p 可选值: 720p1080p4k
audio boolean 可选

是否生成与画面同步的原生音频（环境声、音效）。

默认 false 示例 true
prefer_multi_shots boolean 可选

是否开启智能分镜：开启后模型根据提示词自动规划多个镜头并切换。

默认 false 示例 true
elements object[] 可选

主体素材，最多 3 组。每组给出名称、简短描述和 2–4 张同一主体的图片，在提示词中用 @名称 引用，让角色或物品在整段视频中保持一致。

name string 必填

主体的唯一名称，不含空格；提示词中以 @名称 引用。

description string 必填

主体的简短描述。

element_input_urls string[] 必填

同一主体的 2–4 张图片 URL，JPG/PNG。

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

晨雾渔港

一张首帧图驱动，3 秒、720p，不带音频的最小图生视频示例。

请求体
{
  "model": "kling-3.0-omni/image-to-video",
  "input": {
    "prompt": "Morning fog slowly lifts over the harbor as the fishing boats rock gently on the water; the low sun breaks through the haze and glints on the wet pier, camera slowly pushes in along the dock. Cinematic, calm, photorealistic.",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/8acba0f00bdacec3.jpg"
    ],
    "duration": 3,
    "resolution": "720p",
    "audio": false
  }
}
首尾帧 + 1080p 音频

传两张图片作为首帧与尾帧，生成 8 秒 1080p 带原生音频的过渡镜头。请把尾帧 URL 替换为你自己的图片。

请求体
{
  "model": "kling-3.0-omni/image-to-video",
  "input": {
    "prompt": "从清晨薄雾笼罩的渔港缓慢过渡到正午阳光下的码头，雾气逐渐散去，水面反光越来越亮，镜头保持平稳推进。写实风格，海浪与海鸥的环境声。",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/8acba0f00bdacec3.jpg",
      "https://example.com/harbor-noon-last-frame.jpg"
    ],
    "duration": 8,
    "resolution": "1080p",
    "audio": true
  }
}
首帧 + 主体素材 + 智能分镜

以首帧图确定画面，用 elements 补充同一角色的 2 张图片并以 @captain 引用，开启智能分镜生成 10 秒多镜头短片。请把示例 URL 替换为可公开访问的主体图片。

请求体
{
  "model": "kling-3.0-omni/image-to-video",
  "input": {
    "prompt": "@captain 从船舱走到甲板，望向远处散开的晨雾，然后开始整理缆绳；多个镜头：舱门中景、远眺特写、甲板全景。清晨柔光，电影感。",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/8acba0f00bdacec3.jpg"
    ],
    "elements": [
      {
        "name": "captain",
        "description": "穿深蓝色雨衣、戴毛线帽的中年渔夫",
        "element_input_urls": [
          "https://example.com/captain-front.jpg",
          "https://example.com/captain-side.jpg"
        ]
      }
    ],
    "duration": 10,
    "resolution": "1080p",
    "audio": false,
    "prefer_multi_shots": true
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的视频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

输出视频的画幅由什么决定?

由 image_urls 中首帧图片的宽高比决定，因此本模型没有 aspect_ratio 参数。

image_urls 传 1 张和 2 张有什么区别?

1 张只指定首帧；2 张时第一张是首帧、第二张是尾帧，模型生成两帧之间的过渡。

图片有什么要求?

JPG/PNG，单张不超过 50MB，最短边不小于 300px，宽高比在 0.4–2.5 之间。

elements 最多能传几组?

图生视频最多 3 组主体，每组 2–4 张同一主体的图片，在提示词中以 @名称 引用。

如何计费?

以 HiAPI 定价页的实时价格为准。 查看价格

下一步