Qwen-Image Edit は、複数画像の入出力をサポートしています。自然言語プロンプトを通じて、画像内のテキスト編集、オブジェクトの追加・削除・移動、被写体のポーズ変更、スタイルの転送、ディテールの強調など、あらゆる操作が可能です。
モデルの概要
入力画像 1 | 入力画像 2 | 入力画像 3 | 出力画像 (複数) | |
|---|---|---|---|---|
![]() | ![]() | ![]() | ![]() | ![]() |
プロンプト: 画像 1 の女の子が、画像 2 の黒いドレスを着て、画像 3 のポーズで座っています。
| モデル名 | モデルの説明 | 出力画像の仕様 |
|---|---|---|
qwen-image-2.0-pro 推奨現在、qwen-image-2.0-pro-2026-04-22 と同じ機能を持ちます | Qwen 画像生成・編集モデルの Pro シリーズは、テキストレンダリング、リアルなテクスチャ、セマンティックな忠実度において強化された機能を提供します。画像生成については、「Qwen-Text to Image」をご参照ください。 | 画像解像度:
|
qwen-image-2.0-pro-2026-06-22 推奨 | ||
| qwen-image-2.0-pro-2026-04-22 | ||
| qwen-image-2.0-pro-2026-03-03 | ||
qwen-image-2.0 推奨現在、qwen-image-2.0-2026-03-03 と同じ機能を持ちます | これは Qwen 画像生成・編集モデルの高速化バージョンで、パフォーマンスと応答速度のバランスが取れています。画像生成については、「Qwen-Text to Image」をご参照ください。 | |
qwen-image-2.0-2026-03-03 推奨 |
API を呼び出す前に、「モデルリスト」で各リージョンでサポートされているモデルを確認してください。
前提条件
呼び出しを行う前に、API キーを取得し、API キーを環境変数としてエクスポートしてください。
SDK を使用して API を呼び出すには、DashScope SDK をインストールしてください。SDK は Python と Java で利用可能です。
HTTP 呼び出し
シンガポールリージョン:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
北京リージョン:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
呼び出す際は、WorkspaceId を実際のワークスペース ID に置き換えてください。
リクエストパラメーター |
この例では、 qwen-image-2.0-pro モデルを使用して 2 つの画像を出力します。 |
リクエストヘッダー | |
Content-Type string (必須)リクエストのコンテンツタイプ。application/json である必要があります。 | |
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
リクエストボディ | |
model string (必須)モデル名。例:qwen-image-2.0-pro。 | |
input object (必須)入力オブジェクト。次のフィールドを含みます:
プロパティ messages array (必須)リクエストコンテンツの配列です。現在、シングルターンの会話のみがサポートされているため、配列には role と content プロパティを持つオブジェクトを厳密に 1 つ含める必要があります。
プロパティ role string (必須)メッセージ送信者のロール。user である必要があります。contentarray (必須)メッセージ本文は、{"image": "..."} フォーマットの 1〜3 個のイメージと、{"text": "..."} フォーマットの単一の編集命令で構成されます。
プロパティ image string (必須)入力画像の URL または Base64 エンコードされたデータ。1~3枚の画像を提供できます。複数画像入力の場合、画像の順序は配列のシーケンスによって定義されます。出力画像のアスペクト比は、最後の画像に基づきます。画像要件:
string(必須)出力画像の望ましいコンテンツ、スタイル、構成を記述するポジティブプロンプト。中国語と英語に対応しています。qwen-image-2.0 シリーズは最大 1,300 トークンを受け付けます。システムは超過したトークンを切り捨てます。注: content 配列には、text オブジェクトを正確に 1 つ含める必要があります。そうでない場合、エラーが発生します。 | |
parameters object (任意)画像生成を制御するための追加パラメーター。
プロパティ n integer (任意)出力画像の数。デフォルト:1。qwen-image-2.0 シリーズのモデルでは、1~6枚の画像を出力することを選択できます。negative_prompt string (任意)出力から除外するコンテンツを記述するネガティブプロンプト。生成を制約するために使用します。中国語と英語をサポートしています。最大 500 文字。各漢字、英字、数字、または記号は 1 文字としてカウントされます。超過した文字は自動的に切り捨てられます。例:低解像度、エラー、最低品質、低品質、変形、指の追加、または悪いプロポーション。size string (任意)width*height フォーマットの出力イメージ解像度。例: "1024*1536"。qwen-image-2.0 シリーズモデル:
一般的なアスペクト比の推奨解像度
bool (任意)インテリジェントなプロンプトリライトを有効にします。デフォルト: true。有効にすると、モデルは肯定的なプロンプト(text)を最適化し、単純なプロンプトの結果を大幅に向上させます。対応モデル: すべてのモデル。watermark bool (任意)"Qwen-Image" ウォーターマークを右下隅に追加します。デフォルト: false。seed integer (任意)乱数シード。有効範囲: [0, 2147483647]。同じ seed 値を設定すると、生成結果の相対的な安定性を維持するのに役立ちます。省略した場合、アルゴリズムはランダムなシードを使用します。注: 画像生成は確率的です。同じ seed を使用しても、呼び出しごとに結果が異なる場合があります。 |
レスポンスパラメーター |
タスクデータ (タスクステータスと画像 URL) は 24 時間のみ保持され、その後自動的に消去されます。生成された画像は速やかに保存してください。 |
output objectモデルの生成結果。
プロパティ choices array結果の選択肢のリスト。
プロパティ finish_reason stringタスクの停止理由。正常に停止した場合は stop が返されます。message objectモデルから返されたメッセージ。
プロパティ role stringメッセージのロールです。値は assistant で固定です。contentarray生成された画像情報を含むメッセージコンテンツ。
プロパティ image string生成された画像の PNG 形式の URL。24 時間有効です。画像を速やかにダウンロードして保存してください。 | |
usage objectこの呼び出しのリソース使用量。成功した場合にのみ返されます。
プロパティ image_count integer生成された画像の数。width integer生成された画像の幅 (ピクセル単位)。height integer生成された画像の高さ (ピクセル単位)。 | |
request_id stringトレースとトラブルシューティングのためのユニークなリクエスト識別子。 | |
code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 | |
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
DashScope SDK の呼び出し
SDK のパラメーター名は、ほとんどが HTTP API と一致しています。パラメーター構造は、言語の特性に基づいてカプセル化されています。パラメーターの完全なリストについては、「Qwen API リファレンス」をご参照ください。
Python SDK の呼び出し
- 潜在的な実行時エラーを避けるため、最新バージョンの DashScope Python SDK をインストールすることを推奨します。詳細については、「SDK のインストールまたはアップグレード」をご参照ください。
- 非同期インターフェイスはサポートされていません。
リクエスト例
レスポンス例
画像 URL は 24 時間有効です。画像を速やかにダウンロードしてください。
input_tokens、output_tokens、およびcharactersフィールドには互換性があります。これらの値は現在 0 に固定されています。
Java SDK を使用した呼び出し
実行時エラーを避けるため、最新の DashScope Java SDK をインストールしてください。「SDK のインストールまたはアップグレード」をご参照ください。
リクエスト例
レスポンス例
画像 URL は 24 時間有効です。画像を速やかにダウンロードしてください。
エラーコード
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご参照ください。
課金とレート制限
- モデルの無料クォータと課金レートについては、「 モデルリスト」をご参照ください。
- モデルのレート制限の詳細については、「Qwen-Image」をご参照ください。
- 課金:正常に生成された画像ごとに課金されます。失敗した呼び出しは課金されず、新規ユーザー無料クォータも消費されません。




