Skip to main content
kling/kling-video-o1 の API リファレンスです。Kling のモデルを Comfy Router が提供します。

クイックスタート

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

スキーマ

入力

string
生成されるビデオフレームのアスペクト比(幅:高さ)。先頭フレーム参照またはビデオ編集機能を使用しない場合に必須です。指定可能な値: 16:9, 9:16, 1:1
string (uri)
このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。形式: uri
string
デフォルト:"\"5\""
ビデオの長さ(秒)。ビデオ編集機能(refer_type: base)を使用する場合、出力の再生時間は入力ビデオと同じになり、このパラメータは無効です。指定可能な値: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
object[]
element ID の設定に基づく参照エレメントリスト。
integer
必須
エレメントID形式: int64
string
カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。
object[]
参照画像リスト。エレメント、シーン、スタイルなどの参照画像を含めることも、ビデオを生成するための先頭フレームまたは終了フレームとして使用することもできます。
string
画像の Base64 エンコードまたは画像URL(アクセス可能であることを確認してください)。サポートされる形式は .jpg/.jpeg/.png です。ファイルサイズは 10MB を超えることはできません。幅と高さの寸法は 300px 以上である必要があり、アスペクト比は 1:2.5 ~ 2.5:1 の範囲です。
string
画像が先頭フレームか終了フレームかを指定します。first_frame は先頭フレーム、end_frame は終了フレームです。現時点では終了フレームのみを指定することはサポートされていません。指定可能な値: first_frame, end_frame
string
デフォルト:"\"pro\""
ビデオ生成モード。std: スタンダードモード。720P のビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモード。1080P のビデオを生成し、より高品質なビデオを出力します。指定可能な値: pro, std
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
テキストプロンプト。ポジティブおよびネガティブな記述を含めることができます。2,500 文字を超えることはできません。エレメント、画像、ビデオを <<<>>> の形式で指定できます。例: <<element_1>>, <<<image_1>>>, <<<video_1>>>。
string
ストーリーボード方式。multi_shot パラメータが true に設定されている場合に必須です。指定可能な値: customize, intelligence
string
デフォルト:"\"off\""
ビデオ生成時にサウンドを同時に生成するかどうか。指定可能な値: on, off
object[]
参照ビデオのリスト。feature の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトは編集対象のビデオです。
string
ビデオのオリジナルサウンドを保持するかどうか。yes は保持、no は保持しないことを示します。指定可能な値: yes, no
string
参照ビデオのタイプ。feature は feature 参照ビデオ、base は編集対象のビデオです。指定可能な値: feature, base
string
必須
アップロードするビデオの URL。.mp4/.mov 形式のみサポートされます。再生時間は 3~10 秒です。解像度は 720px 以上 2160px 以下である必要があります。フレームレートは 24~60 fps をサポートします。アップロードできるビデオは 1 本のみで、サイズは 200MB を超えることはできません。
object
ウォーターマーク付きの結果を同時に生成するかどうか。現時点ではカスタムウォーターマークはサポートされていません。
boolean
true はウォーターマークを生成、false は生成しないことを意味します。
GET /v2/models/kling/kling-video-o1/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。

出力

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 が現在対応していないことと、代替手段。