qwen/qwen-image-3.0 の API Reference です。
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、生の HTTP で同じ呼び出しを行います。
モデル ID: qwen/qwen-image-3.0
エンドポイント: POST https://api.comfy.org/v2/models/qwen/qwen-image-3.0
- Wait for the result
- Queue and collect later
スキーマ
入力
object
必須
リクエストメッセージを含む入力パラメータオブジェクト
object[]
必須
リクエストコンテンツの配列。サポートされるのは単一ラウンドの会話のみであるため、配列には必ず1つのオブジェクトだけを含める必要があります
object[]
必須
メッセージコンテンツの配列。テキストから画像への生成では1つのテキストオブジェクト、画像編集では1〜3個の画像オブジェクトと1つのテキストオブジェクトを含みます
string
入力画像のURLまたはBase64エンコードされたデータ。画像編集では1〜3枚の画像をサポートします
string
生成または編集する画像の内容、スタイル、構図を記述するポジティブプロンプト
string
必須
メッセージ送信者の役割。ユーザーに設定する必要があります取り得る値:
userstring
マルチモーダルな画像生成と編集のために呼び出すモデルのID。利用可能な値は qwen-image-3.0-pro と qwen-image-3.0 です。Comfy Router が /v2/models/qwen/{model} の
{model} パスセグメントから補完するため、このスキーマの required リストには含まれていません。そのため Router の呼び出し元は省略しますが、/proxy/ ルートへの v1 直接呼び出しでは指定する必要があります。object
画像生成を制御する追加のパラメータ
integer
デフォルト:"1"
出力画像の枚数。範囲は1〜6、デフォルトは1です範囲:
1 から 6string
画像に表示したくない内容を記述するネガティブプロンプト
boolean
デフォルト:"true"
インテリジェントなプロンプト書き換えを有効にするかどうか。デフォルトは true です
string
デフォルト:"\"direct\""
プロンプトの書き換え方法。direct(デフォルト、テキストから画像への生成と画像から画像への生成でサポート)または agent(テキストから画像への生成のみ)取り得る値:
direct、agentinteger
ランダム性を制御する乱数シード。範囲 [0, 2147483647]範囲:
0 から 2147483647string
出力画像の解像度。widthheight 形式で指定します(例: 10241024)。API はピクセル面積 262144(512512)から 6553600(25602560)の範囲で、アスペクト比 1:8 から 8:1 までの値を受け付けます。指定しない場合、モデルがプロンプトに基づいて解像度を自動的に推奨します
boolean
デフォルト:"false"
ウォーターマークを追加するかどうか。デフォルトは false です
GET /v2/models/qwen/qwen-image-3.0/openapi.json で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じです。
出力
string
失敗したリクエストのエラーコード(リクエストが成功した場合は返されません)
string
失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません)
object
モデルの生成結果を含みます
object[]
結果オプションのリスト
string
タスクが停止した理由。タスクが正常に完了した場合の値は stop です
object
モデルから返されたメッセージ
object[]
生成済み画像の情報を含むメッセージコンテンツ
string
生成済み画像の PNG 形式の URL。リンクは24時間有効です
string
画像の代わりに返されるテキスト要素。このフィールドのみを持つ要素はアセットを生成していないため、呼び出し元はコンテンツ要素の有無ではなく
image を基準に完了を判定しますstring
メッセージの役割。assistant で固定です
string
一意のリクエスト識別子
object
この呼び出しのリソース使用量。成功時のみ返されます
integer
リクエスト内の入力画像の枚数。テキストから画像への生成の場合は 0 を返します
string
入力画像の課金ティア。qima_input_1k または qima_input_2k で、出力解像度のピクセル面積によって決まります
integer
最終的な出力画像の高さ(ピクセル単位)
integer
実際に返された出力画像の枚数
string
出力画像の課金ティア。qima_output_1k または qima_output_2k で、出力解像度のピクセル面積によって決まります
integer
最終的な出力画像の幅(ピクセル単位)
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。