跳转到主要内容
更新日期：2026-06-24

​
AIGC Kling VOD 调用方法

aigc-video-kling-* 是 Crazyrouter 通过 Tencent VOD 线路接入的 Kling 视频模型。它和原生 Kling 文档里的 /kling/v1/videos/* 路径不同，对客调用使用 OpenAI 风格的视频异步接口： 
POST /v1/video/generations
GET /v1/video/generations/{task_id}
调用 VOD 线路时必须使用 aigc-video-kling-* 模型名。不要把 kling-v2-5-turbo、kling-v2-6、kling-v3 直接提交到本页接口，否则可能会命中原生 Kling 线路。

​
可用模型

模型上游版本适合能力
aigc-video-kling-1.6Kling 1.6文生、图生、首尾帧、参考图
aigc-video-kling-2.0Kling 2.0文生、图生、首尾帧、参考图
aigc-video-kling-2.1Kling 2.1文生、图生、首尾帧、参考图
aigc-video-kling-2.5-turboKling 2.5 Turbo文生、图生、首尾帧、参考图
aigc-video-kling-2.6Kling 2.6文生、图生、首尾帧、参考图、视频输入
aigc-video-kling-2.6-motion-controlKling 2.6 Motion Control动作控制
aigc-video-kling-3.0Kling 3.0文生、图生、首尾帧、参考图
aigc-video-kling-3.0-turboKling 3.0 Turbo文生、图生、参考图
aigc-video-kling-3.0-motion-controlKling 3.0 Motion Control动作控制
aigc-video-kling-o1Kling O1文生、图生、参考图、视频输入
aigc-video-kling-avatarKling Avatar数字人 / Avatar
aigc-video-kling-identifyfaceKling Identifyface对口型
Tencent VOD 文档中的 GV 3.1、3.1-fast、3.1-lite 是 Google Veo 线路，不是 Kling 3.1。请使用单独的 aigc-video-gv-* 模型。

​
创建任务

POST https://api.crazyrouter.com/v1/video/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

​
通用参数

参数类型必填说明
modelstring是使用本页的 aigc-video-kling-* 模型名
promptstring条件必填文生视频必填；多镜头或部分图生场景可放在扩展参数中
seconds / durationstring / number否视频时长，常用 5 或 10，默认按 5 秒处理
sizestring否如 1280x720、720x1280，会推导输出比例
imagestring否单图生视频首帧 URL
imagesarray[string]否第一张作为首帧；第二张可作为尾帧或参考图
metadataobject否VOD Kling 扩展参数，见下方字段表

​
常用 metadata 字段

字段说明
resolution输出规格，如 720P、1080P、2K、4K
aspect_ratio输出比例，如 16:9、9:16、1:1
sound是否生成声音，支持 true / false、on / off
image_urls首帧 / 尾帧数组，最多 2 张
image_tail / last_frame_url尾帧 URL，优先级高于 image_urls[1]
image_list多参考图列表，最多 9 张
multi_shots / multi_shot多镜头开关
shot_type分镜类型
multi_prompt多镜头提示词数组
kling_elements / element_listKling 元素控制
camera_control运镜控制
motion_brush / dynamic_masks动作控制参数
video_list视频参考输入，常用于 O1 或视频输入类能力
voice_list声音参考输入
session_id / face_choose对口型相关参数

​
文生视频

cURL
curl -X POST https://api.crazyrouter.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aigc-video-kling-2.6",
    "prompt": "a red square logo slowly rotating on a clean white background",
    "size": "1280x720",
    "seconds": "5",
    "metadata": {
      "resolution": "720P",
      "sound": false
    }
  }'

​
图生视频

cURL
curl -X POST https://api.crazyrouter.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aigc-video-kling-2.5-turbo",
    "prompt": "make the picture gently move with a slow camera push in",
    "image": "https://example.com/input.png",
    "size": "1280x720",
    "seconds": "5",
    "metadata": {
      "resolution": "720P"
    }
  }'

​
首尾帧视频

cURL
curl -X POST https://api.crazyrouter.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aigc-video-kling-2.6",
    "prompt": "transition naturally from the first frame to the last frame",
    "images": [
      "https://example.com/first.png",
      "https://example.com/last.png"
    ],
    "seconds": "5",
    "metadata": {
      "resolution": "720P",
      "sound": false
    }
  }'
Kling 2.6 首尾帧建议显式传 metadata.sound=false。

​
多参考图

cURL
curl -X POST https://api.crazyrouter.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aigc-video-kling-3.0",
    "prompt": "keep the same character identity and create a cinematic walking shot",
    "seconds": "5",
    "metadata": {
      "resolution": "720P",
      "image_list": [
        "https://example.com/ref-1.png",
        "https://example.com/ref-2.png"
      ]
    }
  }'

​
动作控制

动作控制能力使用专门模型名，例如 aigc-video-kling-2.6-motion-control 或 aigc-video-kling-3.0-motion-control。
cURL
curl -X POST https://api.crazyrouter.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aigc-video-kling-3.0-motion-control",
    "prompt": "animate the selected subject moving from left to right",
    "image": "https://example.com/input.png",
    "seconds": "5",
    "metadata": {
      "resolution": "720P",
      "dynamic_masks": [
        {
          "mask_url": "https://example.com/mask.png",
          "trajectories": [
            { "x": 220, "y": 380 },
            { "x": 620, "y": 380 }
          ]
        }
      ]
    }
  }'

​
O1 视频输入

aigc-video-kling-o1 可通过 metadata.video_list 传入视频参考。是否带视频输入会影响计费规格。
cURL
curl -X POST https://api.crazyrouter.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aigc-video-kling-o1",
    "prompt": "use the reference video motion style and generate a new cinematic shot",
    "seconds": "5",
    "metadata": {
      "resolution": "720P",
      "video_list": [
        { "url": "https://example.com/reference.mp4" }
      ]
    }
  }'

​
Avatar 与对口型

Avatar 使用 aigc-video-kling-avatar： 
{
  "model": "aigc-video-kling-avatar",
  "prompt": "a presenter speaks naturally to the camera",
  "image": "https://example.com/avatar.png",
  "seconds": "5",
  "metadata": {
    "resolution": "720P",
    "voice_list": [
      { "url": "https://example.com/voice.wav" }
    ]
  }
}
对口型使用 aigc-video-kling-identifyface。如果业务侧已经有上游识别得到的 session_id 和 face_choose，可放到 metadata 中： 
{
  "model": "aigc-video-kling-identifyface",
  "prompt": "lip sync the face with the provided voice",
  "image": "https://example.com/face.png",
  "seconds": "5",
  "metadata": {
    "resolution": "720P",
    "session_id": "SESSION_ID",
    "face_choose": "FACE_ID",
    "voice_list": [
      { "url": "https://example.com/voice.wav" }
    ]
  }
}
对口型完整流程通常需要先做面部识别，再提交视频生成任务。没有 session_id / face_choose 时，上游可能返回参数错误。

​
查询任务

创建任务返回 id 或 task_id 后，用同一套兼容路径查询：
cURL
curl https://api.crazyrouter.com/v1/video/generations/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"
完成后通常会返回归档后的视频 URL： 
{
  "code": "success",
  "data": {
    "status": "succeeded",
    "task_id": "vod_task_abc123",
    "url": "https://media.crazyrouter.com/task-artifacts/example.mp4"
  }
}

​
与原生 Kling 的区别

项目AIGC Kling VOD原生 Kling
模型名aigc-video-kling-*kling-v2-5-turbo、kling-v2-6、kling-v3
创建路径POST /v1/video/generationsPOST /kling/v1/videos/text2video 等
查询路径GET /v1/video/generations/{task_id}GET /kling/v1/videos/{type}/{task_id}
主要字段model、prompt、seconds、image、images、metadatamodel_name、prompt、image_urls、duration 等
适合场景走 Tencent VOD 线路、使用 VOD 价格和能力走原生 Kling 协议
价格、折扣和可用规格以 Pricing 页面 为准。