kling/kling-3.0-turbo の API リファレンス。Kling から Comfy Router が提供します。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。
モデル ID: kling/kling-3.0-turbo
エンドポイント: POST https://api.comfy.org/v2/models/kling/kling-3.0-turbo
- Wait for the result
- Queue and collect later
スキーマ
入力
object
コールバックアドレスやウォーターマークオプションなどの一般設定。
string
タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。
string
カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。
object
ウォーターマーク付きの結果を同時に生成するかどうか。カスタムウォーターマークには対応していません。
boolean
true の場合はウォーターマーク付きの結果を生成し、false の場合は生成しません。デフォルトは false。
string
必須
ポジティブとネガティブの両方の記述を含めることができるプロンプト。推奨の長さは 2500 文字以下です。マルチショットビデオでは “shot n, m, words; shot n, m, words;” の形式を使用します。
object
解像度、アスペクト比、再生時間などの出力設定。
string
生成されるフレームのアスペクト比(幅:高さ)。“16:9”、“9:16”、“1:1” のいずれか。デフォルトは “16:9”。指定可能な値:
16:9, 9:16, 1:1integer
ビデオの長さ(秒)。対応する値は 3 から 15 です。デフォルトは 5。範囲:
3 から 15string
生成されるビデオの鮮明さ。“720p” または “1080p” のいずれか。デフォルトは “720p”。指定可能な値:
720p, 1080pGET /v2/models/kling/kling-3.0-turbo/openapi.json で提供するドキュメント、つまりリクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。
出力
integer
エラーコード。0 は成功を示します。
object[]
クエリに一致するタスク。
object[]
タスクの課金詳細。
string
消費量。小数点以下 2 桁まで正確です。
string
消費アカウントの種類。残高の場合は “cash”、リソースパッケージの場合は “unit”。
string
消費可能なリソースバンドルの種類(charge_type が “unit” の場合のみ存在)。“video”、“image”、“audio” のいずれか。
integer
タスクの作成時刻。ミリ秒単位の Unix タイムスタンプ。フォーマット:
int64string
このタスクのカスタムタスク ID(存在する場合)。
string
タスク ID。
string
タスクのステータス情報。タスクが失敗した場合は失敗理由を表示します。
object[]
タスクの生成済み出力。
string
生成されるビデオの再生時間(秒)。
string
グループ化マーカー。グループ化された画像の場合のみ存在します。
string
システムが生成した出力 ID。
string
生成される MP3 オーディオの再生時間(秒)。
string
生成されるオーディオの MP3 URL(直リンク防止あり)。
string
生成されるマテリアルの名前。
string
マテリアルのソース。“kling” は公式ライブラリを示し、数値はクリエイター ID です。
string
マテリアルのステータス。“succeeded” または “deleted” のいずれか。
string
出力コンテンツの種類。“video”、“image”、“audio”、“voice”、“element” のいずれか。
string
生成された結果の URL(直リンク防止あり)。30 日後にクリアされます。
string
ウォーターマーク付きの結果の URL(直リンク防止あり)。
string
生成される WAV オーディオの再生時間(秒)。
string
生成されるオーディオの WAV URL(直リンク防止あり)。
string
タスクのステータス。“submitted”、“processing”、“succeeded”、“failed” のいずれか。
integer
タスクの更新時刻。ミリ秒単位の Unix タイムスタンプ。フォーマット:
int64string
エラーメッセージ。
string
システムが生成したリクエスト ID。
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。