メインコンテンツへスキップ
kling/kling-v2-5-turbo の API リファレンスです。Comfy Router が Kling から提供しています。 入力: 画像、テキスト · 出力: ビデオ

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk および npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で実行するものです。 モデル ID: kling/kling-v2-5-turbo エンドポイント: POST https://api.comfy.org/v2/models/kling/kling-v2-5-turbo
同じボディを POST https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests に送信します。Router は実行が受け付けられ次第 201 と request_id を返し、結果は準備が整った時点で、このプロセスからでも別のプロセスからでも取得できます。ステータス、キャンセル、結果の取得の詳細はキュー配信を参照してください。

スキーマ

入力

string
デフォルト:"\"16:9\""
ビデオのアスペクト比指定可能な値: 16:9, 9:16, 1:1
string (uri)
コールバック通知先アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。形式: uri
object
object
number
カメラの水平軸(x 軸)に沿った移動を制御します。負の値は左、正の値は右を示します。範囲: -10 から 10
number
カメラの垂直面内での回転(x 軸)を制御します。負の値は下方向への回転、正の値は上方向への回転を示します。範囲: -10 から 10
number
カメラのロール量(z 軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。範囲: -10 から 10
number
カメラの水平面内での回転(y 軸)を制御します。負の値は左への回転、正の値は右への回転を示します。範囲: -10 から 10
number
カメラの垂直軸(y 軸)に沿った移動を制御します。負の値は下方向、正の値は上方向を示します。範囲: -10 から 10
number
カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。範囲: -10 から 10
string
事前定義されたカメラ移動タイプ。simple: カスタマイズ可能なカメラ移動。down_back: カメラが下降して後退します。forward_up: カメラが前進して上に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。指定可能な値: simple, down_back, forward_up, right_turn_forward, left_turn_forward
number
デフォルト:"0.5"
ビデオ生成における柔軟性。値が高いほど、モデルの柔軟性の度合いが低くなり、ユーザーのプロンプトとの関連性が強くなります。範囲: 0 から 1形式: float
string
デフォルト:"\"5\""
ビデオの長さ(秒)指定可能な値: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
string
カスタマイズされたタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
string
モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
object[]
各ストーリーボードのプロンプトや再生時間などの情報。最大 6 個、最小 1 個のストーリーボードをサポートします。multi_shot が true かつ shot_type が customize の場合に必須です。
string
このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
integer
ショットの連番
string
このストーリーボードのプロンプト。最大長 512 文字。
boolean
デフォルト:"false"
マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type および multi_prompt パラメータは無効です。
string
ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブ文を記述して補足することが推奨されます。
string
ポジティブテキストプロンプト。voice_list パラメータの順序に一致する音声を指定するには、<<<voice_1>>> を使用します。タスクは最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。
string
ストーリーボード方法。multi_shot パラメータが true に設定されている場合に必須です。指定可能な値: customize, intelligence
string
デフォルト:"\"off\""
ビデオ生成時にサウンドを同時に生成するかどうか。このパラメータをサポートするのは V2.6 以降のモデルバージョンのみです。指定可能な値: on, off
object[]
ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リスト順に prompt 内で <<<voice_1>>> および <<<voice_2>>> として参照します。sound を “on” に設定する必要があり、この設定は V2.6 以降のモデルバージョンのみがサポートします。それより前のモデルでは、または sound をデフォルトの “off” のままにした場合、音声は適用されません。
string
必須
音声カスタマイズ API を通じて返された音声 ID、またはシステムプリセットの音声 ID。
object
透かし入りの結果を同時に生成するかどうか。現時点ではカスタム透かしはサポートされていません。
boolean
true は透かしを生成することを意味し、false は生成しないことを意味します。
string
参照画像: URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。
string
参照画像: 終了フレームの制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。
string
デフォルト:"\"std\""
ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間のビデオを生成しますが、出力品質は高くなります。指定可能な値: std、pro
Router が GET /v2/models/kling/kling-v2-5-turbo/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。

出力

integer
エラーコード
object
integer
タスク作成時間、Unix タイムスタンプ(ミリ秒)
string
タスクの控除単位数
string
タスク ID
object
string
object
object[]
string
ビデオの合計再生時間(秒)
string
生成されたビデオ ID
string (uri)
生成されたビデオの URL形式: uri
string (uri)
ウォーターマーク付きの生成されたビデオの URL(ホットリンク保護形式)形式: uri
string
タスクステータス指定可能な値: submitted、processing、succeed、failed
string
タスクステータス情報。タスクが失敗した場合は失敗理由を表示します
integer
タスク更新時間、Unix タイムスタンプ(ミリ秒)
object
boolean
string
エラーメッセージ
string
リクエスト ID

例

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。 上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。 このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。