Kuaishou

Kling 3.0

kling-3.0-omni/reference-to-video

统一多模态视频生成系列，支持文生视频、图生视频、参考生视频与视频内编辑，原生口型同步与多语言音频

kling-3.0-omni/image-to-video kling-3.0-omni/reference-to-video kling-3.0-omni/text-to-video kling-3.0-omni/transformation kling-3.0/image-to-video kling-3.0/motion-control kling-3.0/text-to-video

试用 kling-3.0-omni/reference-to-video

输入

主体

作品灵感

查看全部作品

输出

video

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

价格

kling-3.0-omni/reference-to-video 每秒

规格	720P	1080P	4K
Sound Off · Without Reference Videos	$0.100	$0.129	$0.479
Sound On · Without Reference Videos	$0.129	$0.1645	$0.479
Sound Off · With Reference Videos	$0.143	$0.193	$0.479
Sound On · With Reference Videos	$0.143	$0.193	$0.479

定位简介

kling-3.0-omni/reference-to-video 是 Kling 3.0 Omni 系列中面向参考图生视频的线路，允许以 1 至 7 张参考图（或结合最多 7 个可复用主体元素）为视觉锚点，配合文本提示生成 3 至 15 秒的视频。支持 720p、1080p、4k 分辨率与 16:9、9:16、1:1 画幅，可开启原生音频与智能多镜头。适合需要保持角色或物体跨镜头一致性、批量产出营销与社交媒体视频的开发者。

核心亮点

多参考图与主体元素双轨锚定——可传 1 至 7 张参考图，或定义最多 7 个含 2 至 4 张图的主体元素并以 @name 在提示中引用。
参考视频可选叠加——支持追加 1 段 3 至 15.5 秒参考视频约束运动与构图，此时参考图与主体合计上限收紧为 4。
分辨率与画幅覆盖竖屏到 4K——输出可选 720p、1080p、4k，画幅涵盖 16:9、9:16、1:1，适配横屏与短视频竖屏分发。
原生音频与多镜头可组合——默认关闭的原生音频与智能多镜头可同时开启，一次生成带声多镜头片段；使用参考视频时两者不可用。

能力说明

多主体一致性生成：通过 elements 定义主体名称、描述与 2 至 4 张同主体图片，在提示中以 @name 调用，让同一角色或物体在多个镜头中保持外观一致。

参考视频约束：传入 1 段 MP4/MOV 参考视频（最大 200MB、3 至 15.5 秒）引导运动与节奏，适合在已有素材基础上做风格化或重拍式生成。

分辨率与画幅控制：按投放渠道选择 720p、1080p 或 4k 输出，并设定 16:9、9:16、1:1 画幅，减少后期裁切与转码。

原生音频与智能多镜头：开启 audio 可同步生成声音，开启 prefer_multi_shots 由模型依据提示自动拆分多镜头；两者在未使用参考视频时均可用。

时长与提示长度可调：输出时长 3 至 15 秒可按叙事需要设定，提示词上限 3072 字符，足以描述主体、动作与镜头调度。

适用场景

品牌营销团队：参考图 + 商品卖点提示——以商品多角度参考图锁定外观，产出带画幅与分辨率规格的短片，直接用于信息流与官网投放。
社交媒体运营：角色元素 + 竖屏脚本——定义固定角色元素后批量生成 9:16 短视频，保持人设一致，用于日更内容生产。
影视动画前期：参考视频 + 分镜提示——用参考视频约束运动节奏，输出多镜头预演片段，供导演确认镜头设计与剪辑点。
电商内容团队：商品图集转视频——上传商品参考图并设定 1:1 或 16:9 画幅，生成展示视频用于详情页与商品主图位。

限制与选型建议

参考图与主体元素合计不得超过 7 个，追加参考视频后收紧至 4 个，且此时原生音频与智能多镜头不可用；单次时长上限 15 秒，长叙事需分段生成再拼接。参考图要求 JPG/PNG、单张不超过 50MB、最短边至少 300px，参考视频限 MP4/MOV、3 至 15.5 秒。若只需单图驱动或纯文本生成，可选用同系列 image-to-video 或 text-to-video 线路；对运动控制有专门要求时可评估 motion-control。

近期更新

查看更新日志 →

模型上新新模型：Kling 3.0 Omni（可灵 O3），通过 POST /v1/tasks 调用。kling-3.0-omn… Oct 12, 2026

常见问题

查看全部常见问题 →

Kling 3.0 Image-to-Video 需要上传图片吗？

需要。当前 kling-3.0/image-to-video 是图生视频线路，输入图负责主体和起始构图，Prompt 负责动作、镜头与环境变化。
Kling 3.0 Image-to-Video 支持哪些时长和分辨率？

当前 HiAPI 请求契约支持 3–15s，输出分辨率为 720p、1080p、4K。可选值以页面参数面板和 API 文档为准。
Kling 3.0 Image-to-Video 如何计费？

任务按输出时长和所选档位计费。页面会跟随全局金额单位显示实时价格，最终扣费以成功任务记录为准。
怎样提高图生视频的主体稳定性？

使用主体清晰、遮挡较少且构图完整的输入图；Prompt 先描述主要动作和镜头，再列出必须保留的外观、材质与背景关系。首次测试建议使用较短时长。

提交生成任务

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必填

当前固定值：kling-3.0-omni/reference-to-video

routestring可选

当前固定值：default

inputobject必填

kling-3.0-omni/reference-to-video 和线路 default 的业务参数对象，见下方参数表。

audioboolean可选默认值: false

是否在生成视频时同步生成与画面匹配的原生音频，布尔值，默认 false；当提供参考视频（video_urls）时不可用。

promptstring必填minLength 1maxLength 3072

描述期望生成的视频内容；如需使用 elements 中的主体，可在提示词中以 @name 形式引用其名称。

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

输出视频时长，单位为秒，整数，取值范围 3-15，默认 5。

elementsarray可选maxItems 7

可复用的主体列表，最多 7 个；每个元素包含名称、简短描述与 2-4 张图片，可在提示词中以 @name 引用。

Array [ object ]

数组元素

namestring必填minLength 1

主体的唯一名称，用于在提示词中以 @name 形式引用，名称中不能包含空格。

descriptionstring必填minLength 1

对该主体的简短描述文本，用于辅助模型识别与还原该主体。

element_input_urlsarray必填minItems 2maxItems 4

同一主体的参考图片数组，需提供 2-4 张，支持 JPG/PNG 格式。

Array [ string ]

image_urlsarray必填minItems 1maxItems 7

参考图片数组，可提供 1-7 张；若添加了参考视频则最多 4 张，且参考图片与主体（elements）合计不超过 7 张（含参考视频时合计不超过 4 张）。支持 JPG/PNG，单张不超过 50MB，边长至少 300 px。

Array [ string ]

resolutionstring可选默认值: "720p"

输出视频分辨率，字符串，默认 720p。

可选项：720p1080p4k

video_urlsarray可选minItems 1maxItems 1

可选的参考视频数组，支持 MP4 或 MOV，单个不超过 200MB，时长 3-15.5 秒，宽高 700-4553 px，帧率 24-60 fps；添加参考视频后不支持原生音频与智能多镜头。

Array [ string ]

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

输出视频的宽高比，字符串，默认 16:9。

可选项：16:99:161:1

prefer_multi_shotsboolean可选默认值: false

是否让模型根据提示词自动规划多个镜头，布尔值，默认 false；添加参考视频后不可用。

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": "kling-3.0-omni/reference-to-video",
  "input": {
    "audio": false,
    "prompt": "…",
    "duration": 5,
    "image_urls": "…",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "prefer_multi_shots": false
  }
}'

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: "kling-3.0-omni/reference-to-video",
    input: {
      "audio": false,
      "prompt": "…",
      "duration": 5,
      "image_urls": "…",
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "prefer_multi_shots": false
    }
  }),
});
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": "kling-3.0-omni/reference-to-video",
        "input": {
          "audio": False,
          "prompt": "…",
          "duration": 5,
          "image_urls": "…",
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "prefer_multi_shots": False
        }
    },
)
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"
    }
  }
}