跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
videos
/
generations
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "kling-v2-6",
    "prompt": "一只金色的猫在阳光明媚的草地上奔跑，慢动作，电影质感",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
}'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}
本接口采用异步模式。提交成功后，接口会返回一个任务 ID。您需要使用该 ID 调用 查询任务状态 接口获取最终生成结果。视频链接有效期为 24 小时，请及时下载。
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "kling-v2-6",
    "prompt": "一只金色的猫在阳光明媚的草地上奔跑，慢动作，电影质感",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
}'

{
  "code": "success",
  "data": "task-wave17486161910001884721"
}

​
认证方式

在请求头中加入 Authorization: Bearer YOUR_API_KEY 进行身份验证。您可以在 令牌管理 页面获取您的 API 密钥。

​
请求参数

​
model
string
必填
固定值：kling-v2-6
​
prompt
string
必填
视频生成的文本描述。例如：“一只金色的猫在阳光明媚的草地上奔跑，慢动作，电影质感”
​
mode
string
默认值:"std"
生成模式：std（标准 720P，仅静音）, pro（专业 1080P，支持音频生成）。
​
duration
number
默认值:"5"
视频时长。支持 5 或 10 秒。
​
aspect_ratio
string
默认值:"16:9"
视频宽高比，支持 16:9, 9:16, 1:1。
​
negative_prompt
string
负向提示词，用于排除不想要的内容。
​
image_urls
array
支持最多 2 张图片 URL。1 张作为首帧，2 张作为首尾帧（需在 pro 模式下）。
​
audio
boolean
默认值:"false"
是否生成配套音频。仅在 pro 模式下有效，且与尾帧输入互斥。
​
watermark
boolean
默认值:"false"
是否添加水印。

​
响应参数

​
code
string
响应状态码 * success - 请求成功，任务已提交
​
data
string
任务 ID，格式为 task-wave{timestamp}{userId}{random}，用于通过 查询任务状态 接口获取生成结果

​
功能支持矩阵

功能标准模式 (std)专业模式 (pro)
分辨率720P1080P
视频时长5s / 10s5s / 10s
首尾帧不支持支持
音频生成不支持支持
运镜控制支持支持

​
使用示例

​
专业模式文生视频 (10s)

{
  "model": "kling-v2-6",
  "prompt": "赛博朋克风格的繁华都市街道，雨夜，霓虹灯反射在积水中",
  "mode": "pro",
  "duration": 10,
  "aspect_ratio": "16:9"
}

​
专业模式图生视频 (首尾帧)

{
  "model": "kling-v2-6",
  "prompt": "镜头缓缓推进，展示人物表情变化",
  "mode": "pro",
  "image_urls": ["https://example.com/start.jpg", "https://example.com/end.jpg"],
  "duration": 5
}

​
注意事项

  • 接口为异步处理，返回任务 ID 后请通过查询接口获取结果。
  • 视频链接有效期为 24 小时，过期后将无法访问，请及时转存。
  • pro 模式下的音频生成功能与双图输入（首尾帧）不可同时使用。