Skip to main content
qwen/qwen-image-3.0-pro の API リファレンス。Qwen のモデルを Comfy Router が提供しています。

クイックスタート

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

スキーマ

入力

object
必須
リクエストメッセージを含む入力パラメータオブジェクト
object[]
必須
リクエストコンテンツの配列。単一ラウンドの会話のみをサポートするため、配列には必ず1つのオブジェクトだけを含める必要があります
object[]
必須
メッセージコンテンツの配列。テキストから画像への生成では1つのtextオブジェクト、画像編集では1~3個のimageオブジェクトと1つのtextオブジェクトを含みます
string
入力画像のURLまたはBase64エンコードされたデータ。画像編集では1~3枚の画像をサポートします
string
生成または編集する画像の内容、スタイル、構図を記述するポジティブプロンプト
string
必須
メッセージ送信者の役割。user に設定する必要があります指定可能な値: user
string
マルチモーダルな画像生成と編集のために呼び出すモデルのID。使用可能な値は qwen-image-3.0-pro と qwen-image-3.0 です。このスキーマの required リストに含まれていないのは、Comfy Router が /v2/models/qwen/{model} の {model} パスセグメントから設定するためです。そのため Router 経由の呼び出しでは省略しますが、/proxy/ ルートへの直接の v1 呼び出しでは指定する必要があります。
object
画像生成を制御する追加パラメータ
integer
デフォルト:"1"
出力画像の枚数。範囲は1~6、デフォルトは1範囲: 1 から 6
string
画像に表示したくない内容を記述するネガティブプロンプト
boolean
デフォルト:"true"
プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true
string
デフォルト:"\"direct\""
プロンプトの書き換え方法。direct(デフォルト、T2I と I2I でサポート)または agent(T2I のみ)指定可能な値: direct, agent
integer
ランダム性を制御する乱数シード。範囲 [0, 2147483647]範囲: 0 から 2147483647
string
高さ 形式の出力画像解像度(例: 10241024)。API は 262144(512512)から 6553600(25602560)までのピクセル面積を、1:8 から 8:1 のアスペクト比で受け付けます。指定しない場合、モデルがプロンプトに基づいて解像度を自動的に推奨します
boolean
デフォルト:"false"
ウォーターマークを追加するかどうか。デフォルトは false
Router が GET /v2/models/qwen/qwen-image-3.0-pro/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。

出力

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