可灵 AI (Kling AI) ビデオ生成フルAPIドキュメント (OpenAI & ネイティブ形式)¶

このインターフェースは new-api を通じて2つの呼び出し方法を提供します： 1. OpenAI 互換モード：標準的なビデオクライアントに適しており、パラメータがマッピングされます。 2. ネイティブ転送モード：パラメータ構造が元のドキュメントと完全に一致しており、直接統合に適しています。

1. OpenAI 互換呼び出し形式 (推奨)¶

エンドポイント: POST /v1/video/generations
認証方式: Authorization: Bearer $API_KEY

1.0 基本的な呼び出し例（curl）¶

curl https://api-cs-al.naci-tech.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "ステージで歌う猫、スポットライトが当たり、4K 高画質、映画のような雰囲気",
    "size": "1280x720",
    "duration": 5
  }'

上記の例は、new-api によって自動的に Kling テキストからビデオへのインターフェース（16:9、5秒）にマッピングされます。

1.1 基本パラメータのマッピング¶

OpenAI フィールド	型	説明	対応するネイティブロジック
`model`	string	モデル名、例：`kling-v2-6`, `kling-video-o1`	バックエンドインターフェースと自動一致
`prompt`	string	ポジティブプロンプト、2500文字以内	`prompt` にマッピング
`image`	string	参照画像 URL	`init_image` にマッピング (自動的に画像からビデオを有効化)
`size`	string	サイズ、例：`1280x720`, `1024x1024`	自動的に `aspect_ratio` (16:9, 1:1 など) に変換
`duration`	number	時間 (秒)、5 または 10 のみサポート	自動的に `duration_string` に変換

1.2 高度な拡張パラメータ (Extra Parameters)¶

OpenAI 標準以外のすべてのフィールドは metadata オブジェクト内に配置する必要があります（またはカスタム JSON をサポートするクライアントでは最上位レベルに配置します）。

kling-v2-6 / kling-v1-6 に適用：

{
  "model": "kling-v2-6",
  "prompt": "歌う猫",
  "metadata": {
    "negative_prompt": "ぼやけ",      // ネガティブプロンプト
    "mode": "pro",                // モード: std, pro
    "cfg_scale": 0.5,             // 自由度 [0, 1]
    "sound": "on",                // 音声を生成するかどうか: on, off
    "callback": "https://...",    // コールバックアドレス
    "params": "user_id_123",      // コールバック透過パラメータ
    "voice_list": [               // 参照される音声
      { "voice_id": "system_v1" }
    ]
  }
}

1.2.1 高度なパラメータを含む完全な curl 例¶

curl https://api-cs-al.naci-tech.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "ステージで歌う猫、スポットライトが当たり、4K 高画質、映画のような雰囲気",
    "size": "1280x720",
    "duration": 10,
    "metadata": {
      "negative_prompt": "ぼやけ、低解像度",
      "mode": "pro",
      "cfg_scale": 0.5,
      "sound": "on",
      "callback": "https://example.com/kling/callback",
      "params": "user_id_123",
      "voice_list": [
        { "voice_id": "system_v1" }
      ]
    }
  }'

kling-video-o1 (Omni) 特有のパラメータ：

{
  "model": "kling-video-o1",
  "prompt": "...",
  "metadata": {
    "images": [                   // 参照画像リスト (最初と最後のフレーム)
      { "image_url": "...", "type": "first_frame" },
      { "image_url": "...", "type": "end_frame" }
    ],
    "elements": [                 // 主体参照リスト
      { "element_id": "obj_123" }
    ],
    "videos": [                   // 参照ビデオ
      { "video_url": "...", "refer_type": "base", "keep_original_sound": "yes" }
    ]
  }
}

2. ネイティブ転送モード (Native API)¶

元のドキュメントで定義された構造を直接使用したい場合は、以下のパスを使用できます。このパスでは、new-api は認証とインテリジェントルーティングのみを行い、ペイロードは変更しません。

テキストからビデオ/画像からビデオ: POST /kling/v1/videos/text2video または /kling/v1/videos/image2video
ステータス照会: GET /kling/v1/videos/text2video/{task_id}

2.0 テキストからビデオへの呼び出し例（curl）¶

curl https://api-cs-al.naci-tech.com/kling/v1/videos/text2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "ステージで歌う猫、スポットライトが当たり、4K 高画質、映画のような雰囲気",
    "negative_prompt": "ぼやけ、低解像度",
    "mode": "std",
    "aspect_ratio": "16:9",
    "duration_string": "5",
    "cfg_scale": 0.5,
    "sound": "on",
    "callback": "https://example.com/kling/callback",
    "params": "user_id_123"
  }'

2.0.1 画像からビデオへの呼び出し例（curl）¶

curl https://api-cs-al.naci-tech.com/kling/v1/videos/image2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "kling-v2-6",
    "prompt": "メインスタイルは変えずに、キャラクターをゆっくりとカメラに近づける",
    "negative_prompt": "ぼやけ、低解像度",
    "init_image": "https://example.com/input-image.jpg",
    "image_tail": "https://example.com/end-frame.jpg",
    "mode": "pro",
    "aspect_ratio": "16:9",
    "duration_string": "10",
    "cfg_scale": 0.6,
    "sound": "on",
    "callback": "https://example.com/kling/callback",
    "params": "user_id_123"
  }'

2.1 テキスト/画像からビデオへのフルパラメータ (Kling V1.6/V2.6)¶

{
  "model": "kling-v2-6",
  "prompt": "string",
  "negative_prompt": "string",
  "init_image": "url",           // 画像からビデオの場合のみ必須
  "image_tail": "url",           // オプション、終了フレーム。これを使用する場合は mode=pro が必要 (std はサポート外、1201エラー)
  "mode": "std",                 // std, pro。image_tail がある場合は pro が必須
  "aspect_ratio": "16:9",        // 16:9, 9:16, 1:1
  "duration_string": "5",        // "5", "10"
  "cfg_scale": 0.5,
  "sound": "on",
  "voice_list": [{"voice_id": "..."}],
  "callback": "url",
  "params": "string"
}

パラメータ制限 (テキスト/画像からビデオ)¶

パラメータ	制限
`model`	列挙型：`kling-v2-5-turbo`、`kling-v2-6`
`prompt` / `negative_prompt`	必須 / オプション、いずれも 2500文字以内
`mode`	列挙型：`std`、`pro`。V1.6 は pro をサポートしていません
`aspect_ratio`	列挙型：`16:9`、`9:16`、`1:1`、デフォルトは `16:9`
`duration_string`	文字列列挙型：`"5"`、`"10"`（秒単位）
`cfg_scale`	範囲 [0, 1]。大きいほどプロンプトに忠実になります
`sound`	列挙型：`on`、`off`。V2.6 以降のモデルのみサポート
`voice_list`	最大 2個。`voice_id` は音声カスタマイズインターフェースまたはシステムプリセットから取得
画像からビデオ `init_image` / `image_tail`	画像からビデオの場合 `init_image` は必須。両方を同時に空にすることはできません。`image_tail` を使用する場合は `mode=pro` を指定する必要があります。kling-v2-6 は std モードで image_tail をサポートしていません（1201エラー）。

2.2 Omni (O1) モデルのフルパラメータ (Kling o1)¶

パスは上記と同じです。model が o1 であることをシステムが検出すると自動的に処理されます。

{
  "model": "kling-video-o1",
  "prompt": "string",
  "images": [
    { "image_url": "url", "type": "first_frame" }, // type: first_frame, end_frame, または参照画像(空)
    { "image_url": "url", "type": "end_frame" }
  ],
  "elements": [
    { "element_id": "string" }
  ],
  "videos": [
    { 
      "video_url": "url", 
      "refer_type": "feature", // feature (特徴参照), base (編集対象)
      "keep_original_sound": "yes" // yes, no
    }
  ],
  "mode": "pro",
  "aspect_ratio": "16:9",
  "duration_string": "10",
  "callback": "url",
  "params": "string"
}

パラメータ制限 (Omni)¶

パラメータ	制限
`prompt`	2500文字以内。ポジティブ/ネガティブな説明を含めることができます
`images`	参照ビデオがある場合: 4枚以内。参照ビデオがない場合: 7枚以内。2枚を超える場合は終了フレームを設定できません。終了フレームのみはサポートされていません（終了フレームがある場合は開始フレームも必要です）。開始フレームまたは開始/終了フレームからビデオを生成する場合、ビデオ編集は使用できません
画像形式	`.jpg` / `.jpeg` / `.png`。1枚 10MB以内。幅/高さ 300px以上。アスペクト比 1:2.5～2.5:1
`elements`	参照ビデオがある場合：「参照画像数 + 主体数」が 4以内。参照ビデオがない場合 7以内
`videos`	最大1セグメント。形式 MP4/MOV。時間 3～10秒。幅/高さ 720～2160px。フレームレート 24～60fps（出力 24fps）。200MB以内。編集対象ビデオ（base）の場合、開始/終了フレームは定義できません
`mode`	列挙型：`std`（標準）、`pro`（プロフェッショナル）
`aspect_ratio`	列挙型：`16:9`、`9:16`、`1:1`。参照画像を開始フレームとして使用したり、ビデオ編集を使用したりする場合、タスクの作成に失敗することがあります
`duration_string`	列挙型：3～10（文字列）。テキストからビデオ/開始フレーム画像からビデオは "5"、"10" のみサポート。ビデオが提供された場合、出力時間は入力時間と一致し、このパラメータは無効になります

3. タスクステータス定数の説明 (共通)¶

ステータステキスト (OpenAI)	ステータスコード (ネイティブ)	説明
`queued`	1	待機中
`processing`	2	処理中 (進捗状況 progress が返されます)
`succeeded`	3	成功
`failed`	4, 5	失敗 / タイムアウト

照会インターフェースについて¶

タスクを送信した後、タスク ID を使用してステータスを照会できます。

1. OpenAI スタイル照会 (推奨)¶

標準的な OpenAI ビデオ応答形式に適用されます。

curl https://api-cs-al.naci-tech.com/v1/video/generations/task_id_here \
  -H "Authorization: Bearer $API_KEY"

2. ネイティブスタイル照会¶

元のドキュメントで定義された生の応答構造を返します。

curl https://api-cs-al.naci-tech.com/kling/v1/videos/text2video/task_id_here \
  -H "Authorization: Bearer $API_KEY"