跳转到主要内容
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"
视频时长。支持 510 秒。
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 模式下的音频生成功能与双图输入(首尾帧)不可同时使用。