Qwen-Image 3.0 API

GoEnhance 経由で qwen-image-3 モデルを使い、画像を 1 枚生成または編集します。プロンプトだけを渡せばテキストから画像生成、参照画像の URL を 1〜3 件添えれば画像編集になります。GoEnhance が提供するのは独立した API アクセスであり、Alibaba の公式 API でも Alibaba の関連会社でもありません。
API キーを作成
Qwen-Image 3.0 API による生成を表現した抽象的なスタジオシーン

生成と編集を 1 つのワークフローへ

1 つのエンドポイント、2 つのモード

/api/v1/images/generations に model: qwen-image-3 を指定して POST します。プロンプトのみならテキストから画像生成、アクセス可能な参照画像 URL を 1〜3 件含めれば編集になります。リクエストごとに画像を 1 枚返します。
画像の生成と編集を示す、ひとつのスタジオシーンに置かれたガラスのオブジェ

設計段階から非同期の結果取得

送信に成功すると img_uuid が返ります。これを保存し、GET /api/v1/jobs/detail をポーリングするか、公開 HTTPS のコールバック URL を指定して processing・success・failed のステータス変化を受け取ります。
非同期の配信を思わせる、ブランド表示のないデータ通路と連続する光の軌跡
生成または編集タスクを送信する前に、ドキュメント記載の項目を確認してください。

Qwen-Image 3.0 API のパラメータ

モデル ID

model には qwen-image-3 という値をそのまま指定します。

プロンプト

生成したい画像や編集内容を 1〜2000 文字で記述します。

アスペクト比

auto を使うか、1:1 から 1:8、8:1 までのドキュメント記載の比率を指定します。

出力ティア

1K または 2K を選択します。ドキュメント上の既定値は 2K です。

参照画像

編集用に、各 10 MB 未満の画像 URL を 1〜3 件まで任意で指定できます。

プロンプト制御

ネガティブプロンプト、シード、direct または agent のプロンプト拡張モードを任意で設定できます。
料金は出力分に参照画像の追加料金を加えた金額です。

Qwen-Image 3.0 API の料金

出力料金

1K・2K いずれの出力も 1.75 トークン、生成画像 1 枚あたり $0.035 に相当します。

参照画像の追加料金

参照画像 1 枚につき 0.19 トークン、1 枚あたり $0.0039 が加算されます。

タスクの計算方法

参照画像を 2 枚含むリクエストは 2.13 トークンです(1.75 + (2 × 0.19))。

Qwen-Image 3.0 API を組み込む

1

リクエストの作成

Authorization ヘッダーに API 認証情報を入れ、model と prompt を含む JSON ボディを POST します。比率、画像サイズ、参照画像 URL は必要なときだけ追加します。
2

タスク ID の保存

code: 0 を確認し、返された img_uuid を保存します。トークン不足や認証エラーのレスポンスは画像結果ではなく失敗として扱ってください。
3

完了の確定

ジョブ詳細エンドポイントをポーリングするか、公開 HTTPS コールバックを使います。タスクが success になってから成果物を受け取り、failed のステータスは明示的に処理してください。
API キーを作成
モデル配信基盤を自前で構築せずに、画像生成と制御された編集を本番ワークフローへ追加できます。

開発者向けユースケース

商品ビジュアル

構造化したプロンプトから、そのまま施策に使える商品コンセプトを作成します。

クリエイティブのバリエーション

広告、投稿、ランディングページ向けに新しいビジュアル案を生成します。

参照画像を使った編集

プロンプトの意図を保ったまま、渡した 1〜3 枚の参照画像を変換します。

地域別キャンペーン

ローカライズしたクリエイティブブリーフから、市場ごとのビジュアル案を作ります。

アセットパイプライン

自動化されたコンテンツ処理の中で、非同期の生成ジョブをキューに入れます。

デザインの試作

最終制作の前に、構図・素材・配色のアイデアを検討します。
料金・入力・連携についてよくある質問への回答です。

Qwen-Image 3.0 API のよくある質問

Qwen-Image 3.0 API のエンドポイントは?

https://api.goenhance.ai/api/v1/images/generations に model: qwen-image-3 を指定して POST リクエストを送信します。

Qwen-Image 3.0 API の料金は?

ドキュメント上の出力料金は 1.75 トークン、つまり $0.035 で、1K でも 2K でも同じです。参照画像 1 枚につき 0.19 トークン、$0.0039 が加算されます。

既存の画像を編集できますか?

はい。image_list に、各 10 MB 未満でアクセス可能な画像 URL を 1〜3 件指定します。テキストから画像生成のみの場合はこの項目を省略してください。

対応するアスペクト比は?

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 に対応しています。1:8 と 8:1 の出力は 1K ティアのみです。

コールバックの仕組みは?

外部から到達できる HTTPS のコールバック URL を指定してください。GoEnhance はジョブ詳細レスポンスと同じ形式で processing・success・failed の変化を送信します。200 以外が返った場合は最大 3 回まで再試行し、1 回あたりのタイムアウトは 3 秒です。

これは Alibaba の公式 API ですか?

いいえ。Qwen は Alibaba に関連していますが、このエンドポイントは GoEnhance が独自に提供しています。Alibaba との提携や推奨を意味するものではありません。Alibaba が運営するサービスについては Alibaba Cloud のドキュメントをご確認ください。

Qwen-Image 3.0 で開発を始める