Kling 视频生成

可用模型

调用时在 model 字段填写控制台开放的模型名。当前 Kling 系列包含以下模型：

四种视频能力

清晰度、模式和声音

如果请求的模型不支持某个组合，例如不支持 4K、动作控制或指定音色，接口会返回 400 类错误。排障时先用 duration: 5、mode: "std"、resolution: "std" 跑通最小请求，再逐步开启更高档位或声音参数。

可用 API 一览

Kling 视频使用异步任务接口：先调用创建接口获得 task_id，再调用对应查询接口获取任务状态和结果视频。当前可用的 Kling 专用 API 如下：

文生视频示例

curl "https://youlai.ai/kling/v1/videos/text2video" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "一位产品经理在明亮办公室中展示手机应用界面，镜头缓慢推进，真实电影感",
    "duration": 5,
    "mode": "std",
    "resolution": "std",
    "task_type": "kling.videos.text2video"
  }'

图生视频示例

curl "https://youlai.ai/kling/v1/videos/image2video" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "让画面中的人物自然转身并微笑，背景保持稳定",
    "image": "https://example.com/first-frame.jpg",
    "duration": 5,
    "mode": "pro",
    "resolution": "pro",
    "task_type": "kling.videos.image2video"
  }'

首尾帧示例

首尾帧仍使用图生视频接口，通过 metadata.image_tail 或 metadata.image_tail_url 传入结束帧。

curl "https://youlai.ai/kling/v1/videos/image2video" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "从第一张图自然过渡到结束姿态，动作连贯，光照一致",
    "image": "https://example.com/start.jpg",
    "duration": 5,
    "mode": "pro",
    "resolution": "pro",
    "task_type": "kling.videos.image2video",
    "metadata": {
      "image_tail": "https://example.com/end.jpg"
    }
  }'

动作控制示例

动作控制使用图片作为主体外观，使用参考视频提供动作。参考视频中的人体或主体需要完整清晰，否则任务可能被上游拒绝。

curl "https://youlai.ai/kling/v1/videos/motion-control" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "保持人物身份和服装一致，让人物按照参考视频做自然手势动作",
    "image": "https://example.com/person.jpg",
    "duration": 5,
    "mode": "std",
    "resolution": "std",
    "task_type": "kling.videos.motion-control",
    "metadata": {
      "video_url": "https://example.com/motion-reference.mp4",
      "character_orientation": "video"
    }
  }'

生成有声视频

支持有声视频的模型可以在 metadata 中开启声音。不同模型对“有声无指定音色”和“有声指定音色”的支持不同，价格也可能不同。

curl "https://youlai.ai/kling/v1/videos/text2video" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "海边咖啡馆外景，人物轻声介绍今日新品，环境音自然",
    "duration": 5,
    "mode": "pro",
    "resolution": "pro",
    "task_type": "kling.videos.text2video",
    "metadata": {
      "generate_audio": true,
      "voice_id": "optional-voice-id"
    }
  }'

查询任务结果

提交成功后会返回平台任务 ID。使用同一能力接口加上任务 ID 轮询结果，直到任务进入 SUCCESS 或 FAILURE。

curl "https://youlai.ai/kling/v1/videos/text2video/TASK_ID" \
  -H "Authorization: Bearer sk-xxxxxxxx"

排障建议