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

Kling 3.0 Omni T2V API

POST /v1/tasks

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

模型概览

模型名称 kling-3.0-omni/text-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 做幂等处理。

适用场景

带原生音频的成片

画面与同步音频一次生成，含多语言对白和口型，省去后期配音，适合社媒短视频和广告片。

promptsound
多镜头叙事短片

单条提示词生成带镜头切换的连贯叙事，适合故事化短视频、分镜验证和创意打样。

promptduration
4K 高清成片

720p / 1080p / 4K 三档，需要高清投放或大屏展示时选 4K（按秒计费，4K 单价最高）。

resolution
横竖屏 + 时长适配

按画面比例与 3-15 秒时长适配不同投放场景，一套提示词覆盖横屏信息流与竖屏短视频。

aspect_ratioduration

请求参数

model string 必填

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

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

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

prompt string 必填

描述要生成视频内容的文本提示词。

resolution enum 可选

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

默认 1080p 可选值: 720p1080p4K
aspect_ratio enum 可选

输出视频的画面比例。

默认 16:9 可选值: 16:99:161:1
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 / 16:9 / 5 秒，开启原生音频，适合需要叙事感的成片。

请求体
{
  "model": "kling-3.0-omni/text-to-video",
  "input": {
    "prompt": "金色夕阳下，一只红狐在风雪覆盖的山脊上疾奔，雪粉飞扬，电影级侧光，平滑跟拍",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5,
    "sound": true
  }
}
4K 自然奇观

4K / 16:9 / 5 秒，超高清成片，适合大屏与高清投放。

请求体
{
  "model": "kling-3.0-omni/text-to-video",
  "input": {
    "prompt": "航拍冰岛黑沙滩，海浪拍打玄武岩柱，晨光中水雾弥漫，缓慢推进，电影感冷色调",
    "aspect_ratio": "16:9",
    "resolution": "4K",
    "duration": 5,
    "sound": false
  }
}
竖屏都市夜景

720p / 9:16 / 8 秒，竖屏短视频，成本更省。

请求体
{
  "model": "kling-3.0-omni/text-to-video",
  "input": {
    "prompt": "雨后夜晚的霓虹街道，地面倒影闪烁，赛博朋克氛围，缓慢横移运镜",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "duration": 8,
    "sound": true
  }
}

获取结果

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

常见问题

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

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

生成的视频带声音吗？

由 sound 参数控制。开启时生成与画面同步的原生音频（含多语言对白和口型），关闭时仅输出画面。含音档价格更高。

怎么拿到生成的视频？

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

支持图生视频吗？

该模型是纯文生视频。需要用首帧图片驱动请用 kling-3.0-omni/image-to-video。

下一步