メインコンテンツへスキップ
更新日: 2026-06-24

AIGC Kling VOD 呼び出しガイド

aigc-video-kling-* は Crazyrouter が Tencent VOD ルートで公開している Kling 動画モデルです。ネイティブ Kling の /kling/v1/videos/* とは呼び出し方式が異なり、OpenAI 風の非同期動画 API を使います。
POST /v1/video/generations
GET /v1/video/generations/{task_id}
VOD ルートを使う場合は、必ず aigc-video-kling-* のモデル名を指定してください。kling-v2-5-turbokling-v2-6kling-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アバター / デジタルヒューマン
aigc-video-kling-identifyfaceKling Identifyfaceリップシンク
Tencent VOD の GV 3.13.1-fast3.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条件付きテキストから動画では必須。マルチショットなどでは metadata に詳細を置けます
seconds / durationstring / number任意動画秒数。通常は 5 または 10。未指定時は 5 秒扱い
sizestring任意1280x720720x1280 など。アスペクト比の推定に使われます
imagestring任意単一画像から動画を作るときの先頭フレーム URL
imagesarray[string]任意1 枚目は先頭フレーム、2 枚目は終端フレームまたは参照画像として扱われます
metadataobject任意VOD Kling 拡張パラメータ

よく使う metadata フィールド

フィールド説明
resolution出力品質。例: 720P1080P2K4K
aspect_ratio出力比率。例: 16:99:161:1
sound音声生成の有無。true / falseon / off
image_urls先頭 / 終端フレーム URL。最大 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_listO1 や動画入力ワークフロー用の動画参照
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-o1metadata.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_idface_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-turbokling-v2-6kling-v3
作成パスPOST /v1/video/generationsPOST /kling/v1/videos/text2video など
照会パスGET /v1/video/generations/{task_id}GET /kling/v1/videos/{type}/{task_id}
主なフィールドmodelpromptsecondsimageimagesmetadatamodel_namepromptimage_urlsduration など
適した用途Tencent VOD ルート、VOD の価格と機能ネイティブ Kling プロトコル
価格、割引、有効な仕様はリアルタイムの Pricing ページ を基準にしてください。