kling/kling-v3 の API リファレンス。Kling から提供され、Comfy Router が配信します。
入力: 画像、テキスト · 出力: ビデオ
クイックスタート
Comfy ワークスペース でキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk および npm install @comfyorg/sdk)を使用します。cURL のスニペットは、raw HTTP 経由の同じ呼び出しです。
モデル ID: kling/kling-v3
エンドポイント: POST https://api.comfy.org/v2/models/kling/kling-v3
- 結果を待つ
- キューに送信して後で取得
同じボディを
POST https://api.comfy.org/v2/models/kling/kling-v3/requests に送信します。Router は実行が受け付けられ次第 201 と request_id を返し、結果は準備が整った時点で、このプロセスからでも別のプロセスからでも取得できます。キュー配信 では、ステータス、キャンセル、結果の取得について説明しています。提供プロバイダー
このモデルは、リクエストで別のプロバイダーを指定しない限り、Comfy Router が直接提供します。以下のプロバイダーも、同じエンドポイントと同じモデル ID でこのモデルを提供しており、model_provider クエリパラメータで選択します。
- Comfy(デフォルト):
POST https://api.comfy.org/v2/models/kling/kling-v3 - Higgsfield、
higgsfield/higgsfield-kling-3-stdとして:POST https://api.comfy.org/v2/models/kling/kling-v3?model_provider=higgsfield - Tencent:
POST https://api.comfy.org/v2/models/kling/kling-v3?model_provider=tencent- 制限: 720P、無音。3〜15 秒(デフォルト 5)。アスペクト比は 16:9、9:16、1:1
invalid_inputで拒否される項目:image、image_tail、sound: "on"、std以外のmode(例:"pro")、multi_shot、multi_prompt、shot_type- フォールバック: Tencent が失敗した場合、リクエストは Kling(デフォルトのプロバイダー)で 1 回再試行されます。オプトアウトするには
fallback_provider=falseを送信してください。拒否された入力と BYOK リクエストはフォールバックしません。
strict_mode のデフォルトは false であるため、Router はこのページに記載されているネイティブのリクエストボディをプロバイダー独自のスキーマに変換し、レスポンスを元の形式に変換して返します。API リファレンスの model_provider、strict_mode、fallback_provider を参照し、この方法でルーティングされるすべてのモデルについては提供プロバイダーを参照してください。
スキーマ
入力
コールバック通知先のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。形式:
uri定義済みのカメラ動作タイプ。simple: カスタマイズ可能なカメラ動作。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上方向にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。指定可能な値:
simple、down_back、forward_up、right_turn_forward、left_turn_forwardモデル名。Comfy Router を使用する場合は、省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
プロンプトや再生時間など、各ストーリーボードに関する情報。最大6個、最小1個のストーリーボードをサポートします。multi_shot が true かつ shot_type が customize の場合に必須です。
このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にすることもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type と multi_prompt パラメータは無効です。
ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには、<<<voice_1>>> を使用します。1つのタスクで最大2つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。
ビデオ生成時に参照する音声のリスト。最大2つの音声をサポートします。リストの順に
prompt 内で <<<voice_1>>> および <<<voice_2>>> として参照します。sound を “on” に設定する必要があります。これをサポートするのは V2.6 以降のモデルのみです。以前のモデルの場合、または sound がデフォルトの “off” のままの場合は、音声は適用されません。参照画像 - URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image というプレフィックスを含めないでください。
参照画像 - 終了フレーム制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control とは同時に使用できません。
動画生成モード。std: コスト効率に優れたスタンダードモード。pro: プロフェッショナルモード。より長い再生時間の動画を、より高品質な出力で生成します。4k: 4K解像度の動画を生成するウルトラHDモード。このモデルファミリーで 4k をサポートするのは kling-v3 のみです。その他の Kling テキストから動画へのモデルは pro/std のみに対応します。指定可能な値:
std, pro, 4kGET /v2/models/kling/kling-v3/openapi.json で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。
出力
例
入力
出力
出荷前の確認
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 が現在対応していないことと、代替手段。