Kling 3.0 Omni I2V API

POST /v1/tasks

复制页面

所有模型都通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

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

Kling 3.0 Omni 图生视频 API，快手可灵出品。上传首帧（或首尾帧）图片驱动生成电影感短视频，自带原生音频，支持 720p / 1080p / 4K 分辨率与 3-15 秒时长。

生产建议

生产环境建议

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

适用场景

首帧驱动成片

用一张图作首帧生成动态视频，画面风格、构图与主体由图片决定，适合让静态海报或插画动起来。

image_urls

图片 + 提示词控运动

首帧定画面，提示词描述运动方向和镜头调度，精确控制动态走向。

image_urlsprompt

首尾帧过渡

传两张图作首帧和尾帧，生成两个画面之间的平滑过渡动画。

image_urls

带音频 + 高清成片

开启原生音频、按需选 720p / 1080p / 4K，满足社媒到大屏的不同投放（按秒计费）。

soundresolution

请求参数

</> 生成示例代码

model string 必填

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

示例 kling-3.0-omni/image-to-video

input object 必填

业务参数对象；Kling 3.0 Omni I2V 的模型专属配置都放在这里。

image_urls string[] 必填

1-2 个图片 URL。1 张=首帧；2 张=[首帧, 尾帧]。支持 JPEG/PNG/WEBP。

prompt string 可选

Optional text prompt to guide the generated motion and style.

resolution enum 可选

输出分辨率，分辨率越高单价越高。

默认 1080p 可选值: 720p1080p4K

duration integer 可选

视频时长（秒，3-15）。时长越长费用越高。

默认 5

sound boolean 可选

是否生成同步原生音频（对白/音效/环境声），开启后价格更高。

默认 false

callback object 可选

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

url string 必填

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

示例 https://your-domain.com/hiapi/callback

when enum 可选

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

默认 final 可选值: final

用例示例

静图动起来

首帧图 + 1080p / 5 秒，开启原生音频，让一张图生成有声短视频。

请求体⧉

{
  "model": "kling-3.0-omni/image-to-video",
  "input": {
    "image_urls": [
      "https://static.hiapi.ai/example/input.jpg"
    ],
    "prompt": "海浪缓缓涌入，光线缓慢扫过画面，电影感运镜",
    "resolution": "1080p",
    "duration": 5,
    "sound": true
  }
}

首尾帧过渡

两张图作首帧与尾帧，720p / 5 秒，生成两画面间的平滑过渡。

请求体⧉

{
  "model": "kling-3.0-omni/image-to-video",
  "input": {
    "image_urls": [
      "https://static.hiapi.ai/example/subject-1.jpg",
      "https://static.hiapi.ai/example/subject-2.jpg"
    ],
    "resolution": "720p",
    "duration": 5,
    "sound": false
  }
}

4K 高清动画

首帧图 + 4K / 5 秒，超高清成片，适合大屏与高清投放。

请求体⧉

{
  "model": "kling-3.0-omni/image-to-video",
  "input": {
    "image_urls": [
      "https://static.hiapi.ai/example/input.jpg"
    ],
    "prompt": "镜头缓缓推进，云层流动，光影变化，电影感",
    "resolution": "4K",
    "duration": 5,
    "sound": false
  }
}

获取结果

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

常见问题

图片怎么传？支持几张？

image_urls 是图片 URL 数组：1 张作首帧；2 张作 [首帧, 尾帧] 生成过渡。支持 JPEG / PNG / WEBP。

Kling 3.0 Omni 图生视频支持哪些分辨率和时长？

分辨率支持 720p / 1080p / 4K，时长 3-15 秒（默认 5 秒）。按分辨率、时长（按秒）和是否开启原生音频计费，4K 单价最高，含音档高于无音档，实时价格见价格页。

怎么拿到生成的视频？

提交后立即返回 taskId，任务进入终态后从 output[].url 下载视频。生产环境建议在请求体顶层传 callback.url 收终态通知，减少无效轮询。

支持纯文生视频吗？

该模型需要首帧图片驱动。只用文本提示词生成请用 kling-3.0-omni/text-to-video。

下一步

• 获取 API Key
• 查看 Kling 3.0 Omni I2V 价格
• 对比 AI 视频 API
• 在线试用 Playground