Skip to main content
Comfy Router が Kling から提供する kling/kling-image-o1 の API Reference です。

クイックスタート

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

スキーマ

入力

string
デフォルト:"\"auto\""
生成画像のアスペクト比 (幅:高さ)。auto は、入力コンテンツに基づいて画像をインテリジェントに生成します。指定可能な値: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto
string (uri)
このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。形式: uri
object[]
要素 ID の設定に基づく参照要素リスト。参照要素と参照画像の合計は 10 を超えてはなりません。
integer
必須
要素 ID形式: int64
string
カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。
object[]
参照画像リスト。画像の Base64 エンコーディングまたは画像 URL (アクセス可能であること) を入力できます。対応形式は .jpg/.jpeg/.png です。ファイルサイズは 10MB を超えることはできません。幅と高さは 300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。参照要素と参照画像の合計は 10 を超えてはなりません。
string
必須
画像の Base64 エンコーディングまたは画像 URL (アクセス可能であること)
string
モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
integer
デフォルト:"1"
生成する画像の数。値の範囲 [1,9]。範囲: 1 から 9
string
必須
テキストプロンプト。ポジティブおよびネガティブの記述を含めることができます。2,500 文字を超えてはなりません。Omni モデルは、要素と画像を含むプロンプトを通じてさまざまな機能を実現できます。画像は <<<>>> の形式で指定します。例: <<<image_1>>>。
string
デフォルト:"\"1k\""
画像生成の解像度。1k は 1K スタンダード、2k は 2K 高解像度、4k は 4K 高解像度です。指定可能な値: 1k, 2k, 4k
string
デフォルト:"\"single\""
単一の画像を生成するか、一連の画像を生成するかを制御します。指定可能な値: single, series
integer
デフォルト:"4"
シリーズ内の画像数。値の範囲 [2,9]。範囲: 2 から 9
Router が GET /v2/models/kling/kling-image-o1/openapi.json で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同一のドキュメントです。

出力

integer
エラーコード
object
integer
タスク作成時間、Unix タイムスタンプ (ミリ秒)
string
タスクの消費ユニット数
string
タスク ID
object
string
顧客定義のタスク ID
object
object[]
integer
画像番号 (0-9)
string (uri)
生成画像の URL形式: uri
string
結果が単一の画像か一連の画像か指定可能な値: single, series
object[]
シリーズ画像の結果リスト
integer
シリーズ画像のシーケンス番号
string (uri)
生成画像の URL形式: uri
string
タスクステータス指定可能な値: submitted, processing, succeed, failed
string
タスクのステータス情報。タスクが失敗した場合は失敗理由 (プラットフォームのコンテンツリスクコントロールに抵触した場合など) を表示します。
integer
タスク更新時間、Unix タイムスタンプ (ミリ秒)
string
エラーメッセージ
string
リクエスト ID

入力

出力

出荷前の確認

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

ヘッダー

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

Router API の利用

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

制限事項

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