Skip to main content
kling/kling-v2-6 の API リファレンスです。Kling が提供し、Comfy Router が配信します。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 モデル ID: kling/kling-v2-6 エンドポイント: POST https://api.comfy.org/v2/models/kling/kling-v2-6

Schema

入力

string
デフォルト:"\"16:9\""
ビデオのアスペクト比指定可能な値: 16:99:161:1
string (uri)
コールバック通知先アドレス形式: 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: 左に回転して前進します。指定可能な値: simpledown_backforward_upright_turn_forwardleft_turn_forward
number
デフォルト:"0.5"
ビデオ生成における柔軟性。値が高いほどモデルの柔軟性の度合いが低くなり、ユーザーのプロンプトとの関連性が強くなります。範囲: 0 から 1形式: float
string
デフォルト:"\"5\""
ビデオの長さ (秒)指定可能な値: 3456789101112131415
string
カスタムタスク ID
string
デフォルト:"\"std\""
ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で、より高品質な出力のビデオを生成します。指定可能な値: stdpro
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_1>>> を使用して、voice_list パラメータの順序に対応するボイスを指定します。1 つのタスクで最大 2 つのトーンを参照できます。トーンを指定する場合、sound パラメータの値は on である必要があります。
string
ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。指定可能な値: customizeintelligence
string
デフォルト:"\"off\""
ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のバージョンのモデルのみです。指定可能な値: onoff
object
ウォーターマーク付きの結果を同時に生成するかどうか。現時点ではカスタムウォーターマークはサポートされていません。
boolean
true はウォーターマークを生成することを意味し、false は生成しないことを意味します。
Router が GET /v2/models/kling/kling-v2-6/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
タスクのステータス指定可能な値: submittedprocessingsucceedfailed
string
タスクのステータス情報。タスクが失敗した場合は失敗理由を表示します
integer
タスク更新時間。Unix タイムスタンプ(ミリ秒)
object
boolean
string
エラーメッセージ
string
リクエスト ID

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

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

Router API の利用

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

制限事項

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