img_uuid が返るので、ポーリングするかコールバックを利用します。GoEnhance が提供するのは独立したアクセス手段であり、Alibaba の公式 API ではありません。Qwen-Image 3.0 Pro API
GoEnhance 経由で Qwen-Image 3.0 Pro を利用し、テキストからの画像生成と参照画像を使った編集を 1 つのエンドポイントで実行できます。プロンプトを送信し、必要に応じて最大 3 件の画像 URL を追加すると
API キーを作成
生成と編集で共通のエンドポイント
プロンプトから生成
image_list を省略すると純粋なテキストからの画像生成になります。対応するアスペクト比と 1K または 2K の出力を選ぶか、ratio: auto に構図を任せてください。
最大 3 枚の参照画像で編集
image_list にアクセス可能な画像 URL を 1〜3 件指定します。並び順によってプロンプトが各ソースをどう参照するかが決まります。参照画像は 1 枚あたり 10MB 未満にしてください。
送信前にリクエストのモード、アスペクト比、ティア、任意の制御項目を検証します。
Qwen-Image 3.0 Pro API のパラメータ
必須のモデル
model に qwen-image-3-pro を指定します。プロンプト
1〜2000 文字のテキストプロンプトが必須です。
アスペクト比
auto か、1:1 から 8:1 までのドキュメント記載 13 種類のアスペクト比から選びます。出力ティア
image_size に 1K または 2K を指定します。デフォルトは 2K です。参照画像
任意で
image_list に URL オブジェクトを 1〜3 件渡せます。いずれも 10MB 未満です。プロンプト制御
任意でネガティブプロンプト、0〜2147483647 のシード、
prompt_extend_mode を追加できます。agent モードはテキストからの画像生成専用です。料金は出力ティアに、参照画像 1 枚ごとの追加料金を加えた額です。
Qwen-Image 3.0 Pro API の料金
1K 出力
ドキュメント記載の料金は、生成 1K 画像 1 枚あたり 2.43 tokens($0.049)です。
2K 出力
ドキュメント記載の料金は、生成 2K 画像 1 枚あたり 4.85 tokens($0.097)です。
ratio: auto のリクエストはこのティアで課金されます。参照画像の追加料金
参照画像 1 枚につき 0.19 tokens($0.0039)が加算されます。
1:8 と 8:1 は 1K ティアのみ対応で、課金も 1K ティアです。3 ステップで Qwen-Image 3.0 Pro を実装
1
1. 組み立てと検証
テキストからの生成か参照画像編集かを決め、プロンプトを書き、アスペクト比と画像 URL を検証してから認証ヘッダーを付けます。
2
2. 送信と保存
model: qwen-image-3-pro を指定して POST し、返ってきた img_uuid を保存します。 3
3. 完了処理
GET /api/v1/jobs/detail をポーリングするか HTTPS コールバックイベントを受け取り、タスクが成功または失敗するまで待ってから、出力を保存するかエラーを処理します。新規の画像生成と、参照画像を使った制御可能なワークフローの両方に対応します。
Qwen-Image 3.0 Pro API のユースケース
商品ビジュアル
キャンペーンにそのまま使えるシーン案を生成したり、承認済みの商品参照画像を新しい環境に配置したりできます。
広告バリエーション
バナー、有料メディア、季節ごとのクリエイティブ検証に向けて、プロンプト主導のビジュアル案を作成します。
デザイン試作
本制作に入る前に、文章で書かれたアートディレクションを画像コンセプトに変換します。
参照画像によるリスタイル
順序付きの参照画像を最大 3 枚使い、構図・被写体のディテール・ビジュアル処理を誘導します。
地域別キャンペーン
実装上のインターフェースは変えずに、地域ごとのシーンバリエーションを作成します。
コンテンツパイプライン
非同期生成を、アプリ内のモデレーション・レビュー・保存・公開の各システムに接続します。
料金、入力、非同期での受け取り、Alibaba API に関する検索意図への回答です。
Qwen-Image 3.0 Pro API のよくある質問
Qwen-Image 3.0 Pro API の料金は?
GoEnhance のドキュメントでは、1K 出力が 1 枚 2.43 tokens($0.049)、2K 出力が 1 枚 4.85 tokens($0.097)、さらに参照画像 1 枚ごとに 0.19 tokens($0.0039)とされています。
これは Alibaba の公式 API ですか?
いいえ。Qwen は Alibaba に関連するモデルですが、このページで説明しているのは GoEnhance が提供する独立した API アクセスです。提携や推奨を意味するものではありません。Alibaba が運営する API が必要な開発者は、Alibaba Cloud のドキュメントをご確認ください。
1 つのエンドポイントで生成と編集の両方ができますか?
はい。image_list を省略すればテキストからの画像生成、参照画像の URL を 1〜3 件含めれば編集になります。エンドポイントが返す生成画像は 1 枚です。
対応しているアスペクト比は?
ドキュメント記載の値は auto、1:1、16:9、9:16、4:3、3:4、2:3、3:2、1:2、2:1、1:4、4:1、1:8、8:1 です。
プロンプト拡張の仕組みは?
デフォルトの direct モードはプロンプトをそのまま使います。agent はより大きく書き換えますが、image_list を含まないテキストからの画像生成リクエストでのみ有効です。
API は画像をすぐに返しますか?
いいえ。送信に成功すると img_uuid が返ります。ジョブ詳細エンドポイントをポーリングするか、コールバックイベントで最終結果を取得してください。
コールバック先が利用できない場合は?
エンドポイントが HTTP 200 を返さない場合、GoEnhance のドキュメントではコールバックを最大 3 回まで再試行し、1 回あたりのタイムアウトは 3 秒とされています。ポーリングは引き続き実用的な回復手段です。
