Kling 2.5 Turbo Text-to-Video

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

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

模型概览

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

从文字生成 5 秒或 10 秒视频，支持横屏、竖屏与方形，包含音轨。

生产建议

生产环境建议

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

适用场景

文字构想

无需图片，从文字描绘动作与环境。

prompt

横屏、竖屏与方形

按发布位置安排画面构图。

aspect_ratio

请求参数

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

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

固定填 kling-2.5-turbo/text-to-video.

示例 kling-2.5-turbo/text-to-video

input object 必填

视频生成参数。

prompt string 必填

描述主体、动作、场景与镜头，1–2500 字符。

duration enum 可选

生成视频的时长（秒）。

默认 5 可选值: 510

aspect_ratio enum 可选

选择横屏、竖屏或方形画面。

默认 16:9 可选值: 16:99:161:1

negative_prompt string 可选

描述不希望出现的内容，最长 2500 字符。

cfg_scale number 可选

调整对提示词的遵循程度，范围 0–1。

默认 0.5

callback object 可选

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

url string 必填

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

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

when enum 可选

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

默认 final 可选值: final

用例示例

湖畔晨光与露营车

描述湖畔薄雾与低机位推镜。

请求体

{
  "model": "kling-2.5-turbo/text-to-video",
  "input": {
    "prompt": "A vintage teal camper van is parked beside a quiet alpine lake at sunrise. Low mist drifts across the water, pine trees and distant snow-capped peaks reflect in the lake. Warm sunlight catches the van and the shoreline. The camera slowly glides forward at water level in one continuous cinematic shot. Natural colors, detailed reflections, no text or logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

获取结果

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

常见问题

可以更改分辨率吗？

没有分辨率选择项。1:1 输出 1440×1440，16:9 输出 1920×1080，9:16 输出 1080×1920。

视频有声音吗？

包含音轨，没有音频开关。对白和音乐有明确要求时，试听成片后按需要编辑。