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

Kling 4.0 Text to Video API

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

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

模型概览

模型名称 kling-4.0/text-to-video
类型 视频生成（文生视频）
接口 POST /v1/tasks
价格 见 HiAPI 定价

可灵 Kling 4.0 文生视频 API，由快手可灵出品。一段文字生成 3-30 秒电影级片段，画面与同步音频一次成型，支持 720p / 1080p 与 16:9、9:16、1:1、21:9 四种画幅。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • 1080p 与长时长任务排队时间明显更长，前端超时门槛建议放到 30 分钟以上。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

带声音的成片

画面和同步音频一起生成，环境音、引擎声、乐器直接写进提示词即可，省掉后期配音。

prompt
单镜头长片段

3-30 秒任意整秒，适合一镜到底的产品演示、氛围空镜和叙事开场。

duration
多平台画幅

16:9、9:16、1:1 与 21:9 超宽屏，同一套提示词覆盖横屏投放、竖屏短视频和宽银幕。

aspect_ratio
高清成片

720p 验证构图，1080p 出正式素材，按秒计费且没有起步价，短片段试错成本低。

resolutionduration

请求参数

model string 必填

固定填 kling-4.0/text-to-video。

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

业务参数对象；Kling 4.0 文生视频的模型专属配置都放在这里。

prompt string 必填

描述画面内容、动作和镜头运动。最长 2500 字符。想要的环境音和声源也写进这段描述里。

resolution enum 可选

输出分辨率，分辨率越高单价越高，1080p 渲染也明显更慢。

默认 720p 可选值: 720p1080p
duration integer 可选

视频时长（秒，3-30 的任意整数）。按输出秒数计费，没有起步价。

默认 5
aspect_ratio enum 可选

输出画面比例，21:9 为超宽电影画幅。

默认 16:9 可选值: 16:99:161:121:9
callback object 可选

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

url string 必填

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

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

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

默认 final 可选值: final

用例示例

黎明林间蒸汽火车

720p / 16:9 / 5 秒，验证层叠蒸汽、低角度金光与引擎声。

请求体
{
  "model": "kling-4.0/text-to-video",
  "input": {
    "prompt": "An old steam train pulls slowly out of a mountain station at dawn, thick white steam billowing into low golden sunlight, pine forest on both sides, slow lateral tracking shot, cinematic depth of field, natural engine rumble and distant birdsong",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}
雨夜天台小提琴

1080p / 16:9 / 5 秒，检查雨滴高光、霓虹虚化与乐器声音。

请求体
{
  "model": "kling-4.0/text-to-video",
  "input": {
    "prompt": "A lone violinist plays on a rain-soaked rooftop at blue hour, neon signs blurring behind her, rain droplets catching rim light, slow push-in, shallow depth of field, cinematic",
    "resolution": "1080p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}
竖屏短广告

720p / 9:16 / 8 秒，竖屏投放，成本更省。

请求体
{
  "model": "kling-4.0/text-to-video",
  "input": {
    "prompt": "Vertical close-up of iced coffee pouring into a glass on a sunlit counter, condensation sliding down the glass, camera locked off, soft cafe ambience",
    "resolution": "720p",
    "duration": 8,
    "aspect_ratio": "9:16"
  }
}

获取结果

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

常见问题

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

分辨率支持 720p 与 1080p，时长 3-30 秒的任意整数（默认 5 秒）。按输出秒数和分辨率计费，没有起步价，实时价格见价格页。

生成的视频带声音吗？

带。音频和画面在同一次生成里完成，输出 MP4 自带音轨。模型没有独立的音频开关，想要的环境音和声源直接写进 prompt 即可。

怎么拿到生成的视频？

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

支持图生视频吗？

这个模型是纯文生视频。需要让指定首帧动起来，请使用 kling-4.0/image-to-video。

下一步