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

Kling 3.0 Omni Transformation API

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

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

模型概览

模型名称 kling-3.0-omni/transformation
类型 视频生成（视频改造）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Kling 3.0 Omni（可灵 O3）视频改造：传入一段源视频和提示词，在保留原有运镜与运动的前提下改写画面风格、场景或主体；输出时长与画幅跟随源视频，支持 720p 至 4k 与 @名称 主体素材。

生产建议

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

适用场景

风格与场景改写

把已有视频换成另一种季节、时间或画风，保留原有运镜与运动。

video_urlsprompt
主体替换

用 elements 传入新主体的多张图片，在提示词中以 @名称 指定替换对象。

elements
高清输出

选择 1080p 或 4k，为已有素材生成更高分辨率的改写版本。

resolution

请求参数

model string 必填

固定填 kling-3.0-omni/transformation。

示例 kling-3.0-omni/transformation
input object 必填

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

prompt string 必填

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

video_urls string[] 必填

待改造的源视频，仅 1 段。MP4/MOV，不超过 200MB，时长 3–15.5 秒，宽高均在 700–4553px，帧率 24–60fps。输出视频的时长与画幅跟随源视频，不生成音频。

resolution enum 可选

输出视频分辨率。

默认 720p 可选值: 720p1080p4k
elements object[] 可选

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

示例 [{"name":"lin","description":"扎马尾、穿浅黄色连衣裙的小女孩","element_input_urls":["https://example.com/lin-front.jpg","https://example.com/lin-side.jpg"]}]
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

用例示例

雨夜改雪夜

保留源视频的运镜与水流运动，把场景改写为冬夜雪景，720p。

请求体
{
  "model": "kling-3.0-omni/transformation",
  "input": {
    "prompt": "Transform the scene into a snowy winter night: the gutter becomes a frozen stream with drifting snowflakes, the paper boat becomes a small glowing paper lantern boat, keep the exact camera motion and water movement from the original video. Cinematic, cold blue tones.",
    "video_urls": [
      "https://static.hiapi.ai/admin-assets/2026/10/13/1791861859228-2b40d774dd4b2262-kling-omni-t2v-golden.mp4"
    ],
    "resolution": "720p"
  }
}
1080p 画风改写

把同一段源视频改写成手绘动画风格，输出 1080p；时长与画幅跟随源视频。

请求体
{
  "model": "kling-3.0-omni/transformation",
  "input": {
    "prompt": "把整段画面改成手绘水彩动画风格：雨水沟变成蜿蜒的水彩溪流，纸船保留白色但带有铅笔线稿边缘，霓虹倒影变成柔和的色块，完全保留原视频的镜头运动与水面流动。",
    "video_urls": [
      "https://static.hiapi.ai/admin-assets/2026/10/13/1791861859228-2b40d774dd4b2262-kling-omni-t2v-golden.mp4"
    ],
    "resolution": "1080p"
  }
}
主体替换 + 4k

用 elements 传入新主体的 2 张图片并以 @fox 引用，把源视频里的纸船替换为该主体，输出 4k。请把示例 URL 替换为可公开访问的主体图片。

请求体
{
  "model": "kling-3.0-omni/transformation",
  "input": {
    "prompt": "把原视频里的纸船替换成 @fox，让它趴在一片漂浮的树叶上顺流而下，完全保留原视频的镜头运动、水面波纹与霓虹倒影。电影感，浅景深。",
    "video_urls": [
      "https://static.hiapi.ai/admin-assets/2026/10/13/1791861859228-2b40d774dd4b2262-kling-omni-t2v-golden.mp4"
    ],
    "elements": [
      {
        "name": "fox",
        "description": "橘色毛发、白色尾尖的小狐狸玩偶",
        "element_input_urls": [
          "https://example.com/fox-front.jpg",
          "https://example.com/fox-side.jpg"
        ]
      }
    ],
    "resolution": "4k"
  }
}

获取结果

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

常见问题

可以指定输出时长或画幅吗?

不可以。输出时长与画幅跟随源视频，本模型没有 duration 和 aspect_ratio 参数。

源视频有什么要求?

MP4/MOV，不超过 200MB，时长 3–15.5 秒，宽高均在 700–4553px，帧率 24–60fps，且只能传 1 段。

会保留源视频的音轨吗?

不会。本模型不生成音频，输出视频没有音轨。

如何替换视频里的主体?

用 elements 传入新主体的 2–4 张图片并命名，在提示词中以 @名称 说明要替换的对象；一次最多 7 组主体。

如何计费?

按最终输出视频的时长计费，以 HiAPI 定价页的实时价格为准。 查看价格

下一步