kling-2.5-turbo API

正確なモデル ID kling-2.5-turbo を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力kling-2.5-turboPOST /v1/videos5.0s

パラメータ: duration=5resolution=1080pratio=16:9

プロンプト： One continuous take, no cuts. A night market grill under plastic awnings, skewers over coals. A cook in a lacquer-red jacket fans the fire once and the sparks refuse to die: they climb, gather and turn into a flock of small orange birds that wheels above the stalls and pours down the length of the street. The camera starts tight on the coals, pulls back and rises with the flock over the awnings. One hard warm key from the grill itself, cold blue street beyond. Real weight and inertia, smoke and heat shimmer, no text.

このサンプルを作成したリクエスト

{
  "model": "kling-2.5-turbo",
  "prompt": "One continuous take, no cuts. A night market grill under plastic awnings, skewers over coals. A cook in a lacquer-red jacket fans the fire once and the sparks refuse to die: they climb, gather and turn into a flock of small orange birds that wheels above the stalls and pours down the length of the street. The camera starts tight on the coals, pulls back and rises with the flock over the awnings. One hard warm key from the grill itself, cold blue street beyond. Real weight and inertia, smoke and heat shimmer, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

認証とエンドポイント

https://modelflare.dev/v1 で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/videos です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

タスクの作成

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-2.5-turbo",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "duration": "5", "mode": "std"
  }'

ポーリングとダウンロード

タスクIDを保存します。 GET /v1/videos/{task_id} をポーリングし、GET /v1/videos/{task_id}/content でダウンロードします。結果 URL は有効期限が切れている可能性があるため、速やかにファイルを転送してください。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

リクエストメモ

Kling は、ファミリー固有の model_name、prompt、mode、duration、image_list、または contents / settings フィールドを使用します。ネイティブ JSON が保存され、転送されます。

リクエストパラメータ

Kling Legacy は、text2video / image2video リクエスト構造で model_name を使用します。モード、解像度、オーディオレーンについては、モデルの公式ページと価格ページを確認してください。

フィールド	必須	注意事項
model_name	はい	kling-2.5-turbo
prompt	条件付き	テキストからビデオへの変換には必須。画像とビデオを結合する
image	条件付き	先頭フレーム画像URLまたはBase64
image_tail	いいえ	オプションの終了フレーム画像
video_url	条件付き	Kling 3.0 モーション コントロールの参考ビデオ
image_list	いいえ	Omni/O1 およびマルチモーダル ワークフローのイメージ リスト
negative_prompt	いいえ	否定プロンプト
mode	いいえ	std / pro / 4k (機種依存)
duration	いいえ	5 / 10（字符串）
multi_shot	いいえ	マルチショットのストーリーボードを有効にする
sound	いいえ	サポートされている場合は同期サウンドを生成します
camera_control	いいえ	カメラ制御がサポートされている場合

入出力制限

Kling 2.5 Turbo は、5/10 秒の固定長および 720p/1080p のレガシー API を使用します。テキストからビデオへの変換とシングルファーストフレームの画像からビデオへの変換はサポートされていますが、ネイティブオーディオ、音声、マルチショット、モーションブラシ、カメラコントロールはサポートしていません。

文書化されたワークフローの例

レガシー モデルは、ワークフローによって model_name、最初/終了フレーム、またはモーション コントロール フィールドを選択します。固定期間と音声制限は、このページの表に従います。

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-2.5-turbo", "prompt": "一只狗在海边奔跑",
    "duration": "5", "mode": "pro", "aspect_ratio": "16:9", "sound": "off"
  }'

エラーと失敗したタスク

無効なモデル パラメーターは、リクエスト ID を含む 4xx を返します。非同期タスクは、作成が成功した後に失敗することもあります。ポーリング応答からの error_code と error_message を最終タスク理由として使用します。異なる JSON 形式で同じリクエストを再試行しないでください。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

動画秒単位課金モデルです。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。