Qwen Image 3.0 APIの利用方法：生成、編集、料金

要約

Qwen Image 3.0 は、Standard（qwen-image-3.0）および Pro（qwen-image-3.0-pro）のバリアントで、テキストから画像生成と参照画像を用いた編集を統合しています。テキストプロンプトから開始し、出力サイズを選び、画像生成リクエストを送信して、すぐに出力を保存します。編集では 1〜3 枚の参照画像と、保持すべき点を明示した指示を含めます。CometAPI では、デプロイ前に実際のルートと互換のリクエストスキーマを必ず確認してください。

重要なポイント

Qwen Image 3.0 API は、Standard（qwen-image-3.0）と Pro（qwen-image-3.0-pro）を通じてテキストから画像生成と参照ガイド付き編集をサポートします。ネイティブ出力は PNG です。
Qwen Image 3.0 API には CometAPI からアクセスできます。開発者は API キーを取得し、サポートされるエンドポイントを確認し、アプリに画像生成を統合できます。
Qwen Image 3.0 API の料金は CometAPI で $0.024/リクエストから。Alibaba Cloud Singapore の料金（Standard 出力画像 $0.030 から、Pro 1K 出力画像 $0.040 から）と比較しています。
Qwen Image 3.0 の画像編集は Alibaba Cloud のネイティブ API で最大 3 枚の参照画像をサポートし、生成は 1 回のリクエストで 1〜6 枚をサポートします。
Qwen Image 3.0 API を統合する際は、プロバイダ固有のパラメータ、認証、課金単位、一時的な画像 URL を本番導入前に検証してください。

Qwen Image 3.0 API とは？

Qwen Image 3.0 API はテキストの指示を画像に変換し、提供された写真やデザインアセットを変換できます。対応シナリオには、多言語ポスター、EC 写真、キャンペーン用モックアップ、背景差し替え、合成画像編集などがあります。

Qwen Image 3.0 Standard（qwen-image-3.0）は、テキストから画像生成と参照ガイド付き編集のためのコスト重視のベースラインです。EC の背景バリエーション、SNS 向けのビジュアル草案、キャンペーンのコンセプト探索など大量処理のワークフローでまず検討してください。例えば、Standard で複数の製品背景案を出力し、製品の忠実度を確認して、精緻化に値するバージョンを選定します。

Qwen Image 3.0 Pro（qwen-image-3.0-pro）は、生成と参照ガイド付き編集をサポートし、より高価格のネイティブ 2K 出力ティアを提供します。キャンペーンのキービジュアル、精巧な製品コンポジション、販促ポスターなど品質重視の成果物に適しています。例えば、細部やレイアウトが重要な場合に Pro で最終候補を検証し、Standard の結果と比較して追加コストに見合う改善があるか判断します。

選び方: コストが重要な草案やバリエーションには Standard から始めましょう。要求の厳しい最終アセットでは同一ブリーフで Pro を試し、測定可能な改善が追加コストを正当化する場合に選択します。どちらの区分も、タイポグラフィ、製品忠実度、オブジェクト数、レイアウト精度などアプリ固有のテストの代替にはなりません。

仕様	Qwen Image 3.0	Qwen Image 3.0 Pro
モデル ID	qwen-image-3.0	qwen-image-3.0-pro
生成/編集	両方	両方
編集用参照画像	1–3	1–3
リクエストあたりの生成画像数	1–6	1–6
出力形式	PNG	PNG
出力ピクセル面積	512²–2048²	512²–2048²
推奨プロンプト長	4,500 トークン	4,500 トークン
主な選択理由	コスト効率の高いスループット	高品質出力の評価

Qwen Image 3.0 API はどのパラメータをサポートしますか？

Alibaba Cloud の OpenAI 互換インターフェースでこれらのパラメータを使用します。CometAPI のリクエストにプロバイダ固有オプションを追加するのは、選択したルートでそれらが文書化されている場合に限ります。

両バリアントに適用: qwen-image-3.0（Standard）と qwen-image-3.0-pro（Pro）は、Alibaba Cloud の OpenAI 互換ネイティブインターフェース上で下記の同一パラメータをサポートします。model でバリアントを選び、生成と編集の制御は共有されます。これは出力品質や価格が同一であること、または CometAPI の全ルートがネイティブの全パラメータを露出することを意味しません。

パラメータ	型/例	用途
model	qwen-image-3.0	Standard か Pro を選択
prompt	string	指示とコンテンツ
image	URL / base64 string or array	編集用の参照 1〜3 枚。生成では省略
size	1024x1024	出力寸法。対応時は自動
n	integer 1–6	1 回の呼び出しあたりの出力数
negative_prompt	string	回避したい内容の記述
prompt_extend	boolean	プロンプト書き換えを有効化
prompt_extend_mode	direct / agent	エージェントモードはテキストから画像のみ
enable_thinking	boolean	推論の制御（拡張設定に依存）
watermark	boolean	任意のウォーターマーク
seed	integer	再現性の補助

ネイティブリクエストでは、出力アスペクト比は 1:8〜8:1 の範囲に収める必要があります。参照画像は最大 10 MB、各辺は 1〜8,000 ピクセル、長辺/短辺比は 10:1 以下である必要があります。Base64 入力には data URI を使用します。Thinking は prompt_extend=true が必要です。エージェント拡張はテキストから画像のみサポートします。

互換の画像リクエストでは、生成用のフィールドを JSON のトップレベルに置き、寸法は 1024x1024 の形式で指定します。ネイティブの DashScope は入れ子の input/parameters を使用し、寸法は 1024*1024 の表記が一般的です。相互に変換せずにエンドポイント間でリクエストをコピーすると失敗する可能性があります。

CometAPI で Qwen Image 3.0 API をどのように呼び出しますか？

この手順は、Python 3、Bash 互換のターミナル、モデルアクセス権のある CometAPI アカウント、十分な残高を前提としています。最初のリクエストは、プロバイダの例に示された model と prompt フィールドのみを使用します。文書は 2026 年 10 月 16 日時点で確認済みで、これらの例は有料アカウントに対して実行されていません。

資格情報を作成

CometAPI ダッシュボードでサーバーサイドの API キーを作成します。Web やモバイルのクライアントに同梱しないでください。

export COMETAPI_KEY="your_api_key"python -m pip install requests

最小限の生成リクエストを送信

開発者は、CometAPI の文書化された画像生成ルートを使って Qwen Image 3.0 API にアクセスできます。以下の最小リクエストから始め、任意パラメータは後から追加しましょう。

curl --fail-with-body https://api.cometapi.com/v1/images/generations \  -H "Authorization: Bearer $COMETAPI_KEY" \  -H "Content-Type: application/json" \  -d '{"model":"qwen-image-3.0","prompt":"石の台座の上に置かれた高級スキンケアボトル、穏やかなスタジオライティング"}'

返却されたすべての画像を保存

以下のスクリプトを generate.py として保存し、python generate.py を実行します。これはリクエストを送信し、URL または Base64 の画像結果を処理して、各画像をローカルに書き出します。レスポンスが data 配列ではなくタスク情報を含む場合、ポーリング用エンドポイントを推測せずに停止します。完了結果の取得には、アカウント固有の非同期契約を使用してください。

import base64import osfrom pathlib import Pathimport requestsresponse = requests.post(    "https://api.cometapi.com/v1/images/generations",    headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"},    json={"model": "qwen-image-3.0", "prompt": "日差しの差し込む本屋カフェ、エディトリアル写真"},    timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images:    raise RuntimeError(f"同期画像がありません。task/error フィールドを確認してください: {list(result)}")for index, item in enumerate(images, 1):    if item.get("url"):        download = requests.get(item["url"], timeout=(15, 120))        download.raise_for_status()        content = download.content    elif item.get("b64_json"):        content = base64.b64decode(item["b64_json"], validate=True)    else:        raise RuntimeError(f"画像 {index} に URL も Base64 ペイロードもありません")    path = Path(f"qwen_image_{index}.png")    path.write_bytes(content)    print(f"{path} を保存しました")

成功するとローカルに画像ファイルが生成されます。開いて読み取り可能かつ要求したシーンに一致することを確認してください。リクエスト ID と usage フィールドは、資格情報を記録しないよう注意しつつサーバーログに保存してください。

Qwen Image 3.0 で複数画像をどのように生成しますか？

Alibaba Cloud のネイティブインターフェースでは、クリエイティブなバリエーションのために n を 2〜6 に設定します。CometAPI では、選択したルートでのサポートを確認してから n を有効化してください。返却された各アセットは個別に検証します。n を大きくしても、すべての結果が後工程の審査を通過する保証はありません。

Qwen Image 3.0 では、n パラメータを設定することで 1 回のリクエストで最大 6 枚の画像を生成できます。これは qwen-image-3.0 と qwen-image-3.0-pro の両方で、テキストから画像生成と画像編集の双方に機能します。デフォルトは 1 枚です。

やり方は主に 2 つあります。プラットフォームに UI がある場合はグラフィカルインターフェースを使うか、API を直接呼び出します。

API で複数画像を生成

API ドキュメントを開く。
QwenCloud コンソール/CometAPI から API キーを取得。
qwen-image-3.0 または qwen-image-3.0-pro を選択。
n を 1〜6 の希望枚数に設定。
プロンプトを送信し、返却された画像を保存。

例: "n": 4 と設定すると、同一プロンプトの 4 つのバリエーションを要求します。

Python の例

OpenAI 互換 API を使った、すぐに応用できる例です。

from openai import OpenAIimport requestsclient = OpenAI(    api_key="YOUR_QWEN_API_KEY",    base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate(    model="qwen-image-3.0-pro",    
prompt=(        "雨の夕方の居心地のよい日本のカフェ、"        "暖かな明かりが灯り、映画的な写真表現、"        "豊かなディテール、リアルな反射"    ),    
n=4,    
size="1024x1024")# 生成された各画像を保存
for i, item in enumerate(result.data, start=1):    response = requests.get(item.url)    response.raise_for_status()    with open(f"qwen_image_{i}.png", "wb") 
as f:        
f.write(response.content)print("画像の生成が完了しました！")

必要なパッケージを先にインストールします:

pip install openai requests

API は各結果の画像 URL を返します。生成された画像 URL は一時的なので、速やかにダウンロードしてください。

重要な設定

パラメータ	役割
n=4	4 枚の出力画像を生成
model="qwen-image-3.0-pro"	Pro モデルを選択
size="1024x1024"	正方形の画像を要求
seed=12345	結果の再現性を高める補助
negative_prompt	不要な視覚要素を除外するための指定

1 回のリクエストでの最大出力数は 6 です。より多くの画像を要求すると、生成コストも増加する点に注意してください。

重要な区別: n=4 は 1 つのプロンプトに対する 4 つのバリエーションを要求します。4 つの異なるプロンプトが必要な場合は、個別のリクエストを送るか、プロンプトをループ処理で自動化してください。

Qwen Image 3.0 で画像を編集するには？

編集は、1〜3 枚の参照画像と指示の組み合わせです。望む変換内容と、変更してはならない点（例: 製品ラベル、色、カメラアングル、パッケージ形状）を両方説明してください。

次の例では Alibaba Cloud の認証情報と、その編集用の JSON 画像フィールドを使用します。リージョンに合った Model Studio のキーを作成し、ワークスペース ID を取得し、対応するエンドポイントを設定してください。このリクエストに CometAPI のキーを代用しないでください。

export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"

以下の参照画像は公式 API の例から直接引用したものです。本記事で生成した結果ではありません。

import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]  
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0", 
"prompt": "カフェでの装いをチャコールのビジネススーツに変更。顔と髪型は保持してください。", 
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"], 
"size": "1024x1024", 
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())

ネイティブの互換エンドポイントは /images/generations で JSON を使用し、/images/edits でのマルチパートアップロードやストリーミングには対応していません。返却された data 配列を読み取り、上記と同じダウンロードループで各 URL を保存してください。

参照が 2 枚の場合は image 配列に 2 つの URL を含め、プロンプトでそれぞれの役割（例: 画像 1 の製品、画像 2 の室内）を指定します。Qwen Image 3.0 シリーズは参照画像を最大 3 枚まで受け付けます。より多くのソースを用いる場合は、別のモデルや前処理ワークフローを使用してください。

Qwen Image 3.0 API の費用はいくらですか？

Qwen Image 3.0 API の価格は、モデルバリアント、出力解像度、プロバイダによって異なります。下表は、Alibaba Cloud Singapore の比較に、レビュアーが添付した価格表の CometAPI 料金を補足したものです。添付には USD/画像の出力価格と、4 つのモデル/解像度の組み合わせすべてに対する 20% 割引が記載されています。これらの提示レートは実アカウントの課金で独自再検証はされていません。本番利用前に適用されるレートカードを確認してください。

料金項目	Alibaba Cloud Standard	Alibaba Cloud Pro	CometAPI
入力参照画像	$0.003/image	$0.003/image	Standard/Pro ともに $0.0024/image
成功した 1K 出力	$0.030/image	$0.040/image	Standard: $0.0240/image; Pro: $0.0320/image
成功した 2K 出力	$0.030/image	$0.075/image	Standard: $0.0240/image; Pro: $0.0600/image
成功した 1K 出力 100 枚	$3.00	$4.00	Standard: $2.40; Pro: $3.20 for 100 output images*
成功した 2K 出力 1,000 枚	$30.00	$75.00	Standard: $24.00; Pro: $60.00 for 1,000 output images*
課金単位	入力/出力画像	入力/出力画像	請求対象の入力参照画像と成功した出力画像あたり（提供された価格表に準拠）
CometAPI の出力価格ディスカウント	1K/2K ともに 20%	1K/2K ともに 20%	入力/出力レートは提供表の公式画像価格の 80%

*上記のボリューム例は出力画像のみを対象としています: 1K の Standard 画像 100 枚は $2.40、Pro 1K 画像 100 枚は $3.20。2K の Standard 画像 1,000 枚は $24.00、Pro 2K 画像 1,000 枚は $60.00。編集では請求対象の入力参照画像 1 枚ごとに $0.0024 を加算。失敗ジョブの扱い、税金、アカウント固有の調整は除外。

提示された入力・出力の画像単価を用いて、どちらのプロバイダでも以下の式で画像料金を見積もれます。

合計コスト =（請求対象の参照画像枚数 × 入力画像単価）+（成功した出力枚数 × 出力画像単価）。

請求対象の参照画像 2 枚と、成功した Standard 1K 出力 3 枚で課金されるジョブの場合、Alibaba Cloud の画像料金は (2 × $0.0030) + (3 × $0.0300) = $0.0960 です。対応する CometAPI の画像料金は (2 × $0.0024) + (3 × $0.0240) = $0.0768 で、提示されたレートに基づきます。

CometAPI は両バリアントで入力参照画像 1 枚あたり $0.0024 を請求します。出力価格は 1K/2K の Standard が $0.0240/画像、Pro の 1K が $0.0320/画像、2K が $0.0600/画像です。提供表では各入力/出力レートが対応する公式価格の 20% 引きとして記載されています。同一の請求対象枚数であれば画像料金は 20% 低くなりますが、追加手数料やアカウント条件により最終請求額は変動する可能性があります。

本番の予算策定では、選択したバリアント、画像解像度、参照画像の課金、リクエストあたりの出力枚数、適用されるアカウント割引を確認したうえで総使用コストを見積もってください。

Qwen Image 3.0 API のエラーはどう扱いますか？

症状	想定される原因	対処
401/403	無効なキー、またはリージョンの不一致	資格情報、権限、デプロイ先リージョンを確認
400 無効な画像	参照の数/型が不正	1〜3 枚、妥当な URL/Base64、サポート形式を使用
400 無効なサイズ	非対応の面積/アスペクト比、または区切り	エンドポイントに合わせて寸法表記を正規化
予期しない JSON	誤ったエンドポイントまたはレスポンス仕様	レスポンスフィールドを記録し、パーサを適合
期限切れの画像 URL	期限前に画像を保存しなかった	生成後すぐにダウンロードして保管
予期しない請求	参照画像や出力ティアの計上漏れ	image usage フィールドと最新のレートカードを参照
ブランドテキストの不一致	生成の制約	審査ゲートや後処理のテキストオーバーレイを使用

よくある質問

タイムアウト後に Qwen Image 3.0 のリクエストを再試行すべきですか？

クライアントのタイムアウトは、生成が停止したことを意味しません。リクエストまたはタスクの識別子を保持し、プロバイダのジョブ履歴やステータス API に従って、出力が既に存在するか確認してから再送してください。無闇なリトライは重複ジョブや追加課金を招きます。一時的な失敗には上限付きリトライを使用し、可能ならプロバイダの冪等性ガイダンスに従ってください。

ローカルの参照画像を Qwen Image 3.0 で使うには？

ネイティブの互換インターフェースでは、ファイルをバイトとして読み込み、Base64 エンコードして、data:image/png;base64, のような data URI を先頭に付けます。その完全な文字列を image に渡してください。Base64 入力でも画像サイズと寸法の制限に従う必要があります。ローカルファイルパスはサービスが取得できる URL ではありません。

OpenAI SDK で Qwen 固有オプションを渡すには？

標準的な画像フィールドは通常の SDK 引数に保持し、image や prompt_extend のような Model Studio の拡張フィールドは extra_body に入れます。生の HTTP リクエストでは、これらのフィールドを JSON のトップレベルに直接配置します。このガイダンスはネイティブの互換インターフェースに適用されます。CometAPI では選択したルートを確認してからプロバイダ固有オプションを転送してください。

Qwen Image 3.0 が要求より少ない画像しか返さない場合は？

まず成功した出力を保存し、実際の件数を記録します。Alibaba Cloud のネイティブ課金では、出力課金は成功した画像に基づきます。追加のアセットが必要な場合は、レスポンスと使用記録を確認したうえで不足分のみを再要求してください。CometAPI の課金は CometAPI 自身のアカウント条件に照らして照合が必要です。

結論

Qwen Image 3.0 は、同一モデルファミリー内で生成と参照駆動の編集を必要とするチームにとって実用的な選択肢です。コスト重視のベースラインには Standard を、2K やクリエイティブ性の高いタスクには Pro を試し、リクエスト単価ではなく受け入れられた出力あたりのコストで判断しましょう。最小限の生成呼び出しから始め、出力を永続化し、その後に適切なプロバイダ契約に従って編集や複数出力を追加します。資格情報とリクエストスキーマを混同せず、エラーを明示的に処理し、選択したレートカードと照合して画像使用量を精算してください。