Qwen-Image は、複数のアートスタイルをサポートし、 複雑なテキストレンダリング に優れた汎用画像生成モデルです。複数行のレイアウト、段落レベルのテキスト生成、および詳細なディテールレンダリングに対応しています。
クイックアクセス: ユーザーガイド| オンラインで試す(シンガポール | 北京)| 技術ブログ (その他の例) |
例
プロンプト | 生成された画像 |
|---|---|
緑豊かな芝生の上で 3 匹の子犬がボールで遊んでいる、癒し系手描きポスター。鳥や星などの装飾要素が散りばめられている。メインタイトル「Come Play Ball!」が、太字の青い漫画風フォントで上部に目立つように表示されている。その下には、サブタイトル「Come [Show Off Your Skills]!」が緑色のフォントで表示されている。吹き出しには「Hehe, watch me amaze my little friends next!」というテキストが書かれており、遊び心のある魅力を加えている。下部には、「We get to play ball with our friends again!」という補足テキストが記載されている。カラーパレットは、新鮮な緑と青を中心に、明るいピンクと黄色のトーンでアクセントをつけ、陽気で子供らしい雰囲気を強調している。 |
|
モデル概要
| モデル | 説明 | 出力画像の仕様 |
|---|---|---|
qwen-image-2.0-pro
| 画像生成および編集用の Qwen プロ版シリーズ。より強力なテキストレンダリング、リアルなテクスチャ、セマンティックな忠実性を提供します。
| 解像度:幅と高さを自由に設定します。総ピクセル数は 512×512 から 2048×2048 の範囲内である必要があります。デフォルトの解像度は 2048×2048 です。 フォーマット:PNG 画像数:1~6 |
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 高速化シリーズ。品質と応答速度のバランスが取れています。
| |
qwen-image-2.0-2026-03-03 |
注記API を呼び出す前に、ご利用のリージョンでサポートされているモデルリストをご確認ください。
前提条件
呼び出しを行う前に、API キーを取得し、API キーを環境変数としてエクスポートしてください。SDK を使用して呼び出しを行うには、DashScope SDK をインストールする必要があります。
重要中国 (北京) リージョンとシンガポールリージョンでは、API キーとリクエストエンドポイントがそれぞれ異なります。これらは相互に利用することはできません。リージョンをまたいだ呼び出しは、認証の失敗やサービスエラーにつながります。
同期 API
HTTP
同期呼び出しは、1 回のリクエストで結果を返します。
シンガポール: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 に置き換えてください。
リクエストパラメーター | Text-to-Image |
リクエストヘッダー | |
Content-Type リクエストのコンテンツタイプです。 | |
Authorization Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
リクエストボディ | |
model モデル名。例: | |
input 入力情報。 | |
parameters 画像処理パラメーター。 |
レスポンスパラメーター | タスク成功画像の URL は 24 時間のみ有効で、その後自動的にパージされます。生成された画像は速やかに保存してください。 タスク失敗タスクが失敗した場合、レスポンスには code および message フィールドにエラーの詳細が含まれます。「エラーコード」をご参照ください。 |
output タスクの出力情報。 | |
usage 注記同期 ImageSynthesis SDK 呼び出しでは、このフィールドは返されません。 出力統計。成功した結果のみをカウントします。 | |
request_id トレースとトラブルシューティングのためのユニークなリクエスト識別子。 | |
code エラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 | |
message 詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
DashScope SDK の呼び出し
DashScope SDK は Python と Java をサポートしています。
SDK のパラメーター名は HTTP パラメーターとほぼ一致しており、パラメーター構造は言語固有の規則に従います。同期呼び出しのパラメーターについては、「HTTP」をご参照ください。
Python
注記実行時エラーを避けるために、最新の DashScope Python SDK をインストールしてください:SDK のインストール。
リクエストの例
import json
import os
import dashscope
from dashscope import MultiModalConversation
# シンガポールリージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
messages = [
{
"role": "user",
"content": [
{"text": "緑豊かな芝生の上で 3 匹の子犬がボールで遊んでいる、癒し系手描きポスター。鳥や星などの装飾要素が散りばめられている。メインタイトル「Come Play Ball!」が、太字の青い漫画風フォントで上部に目立つように表示されている。その下には、サブタイトル「Come [Show Off Your Skills]!」が緑色のフォントで表示されている。吹き出しには「Hehe, watch me amaze my little friends next!」というテキストが書かれており、遊び心のある魅力を加えている。下部には、「We get to play ball with our friends again!」という補足テキストが記載されている。カラーパレットは、新鮮な緑と青を中心に、明るいピンクと黄色のトーンでアクセントをつけ、陽気で子供らしい雰囲気を強調している。"}
]
}
]
# API キーは北京リージョンとシンガポールリージョンで異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
# 環境変数を設定していない場合は、以下の行を api_key="sk-xxx" に置き換えてください。
api_key = os.getenv("DASHSCOPE_API_KEY")
response = MultiModalConversation.call(
api_key=api_key,
model="qwen-image-2.0-pro",
messages=messages,
result_format='message',
stream=False,
watermark=False,
prompt_extend=True,
negative_prompt="低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、蝋人形のような外観、顔のディテールの欠如、過度の滑らかさ、AI のようなアーティファクト、混沌とした構図、ぼやけたまたは歪んだテキスト。",
size='2048*2048'
)
if response.status_code == 200:
print(json.dumps(response, ensure_ascii=False))
else:
print(f"HTTP ステータスコード: {response.status_code}")
print(f"エラーコード: {response.code}")
print(f"エラーメッセージ: {response.message}")
print("ドキュメントを参照してください: https://www.alibabacloud.com/help/model-studio/error-code")
レスポンスの例
画像の URL は 24 時間後に有効期限が切れます。速やかに画像をダウンロードしてください。
{
"status_code": 200,
"request_id": "d2d1a8c0-325f-9b9d-8b90-xxxxxx",
"code": "",
"message": "",
"output": {
"text": null,
"finish_reason": null,
"choices": [
{
"finish_reason": "stop",
"message": {
"role": "assistant",
"content": [
{
"image": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.png?Expires=xxx"
}
]
}
}
]
}
}
Java
注記最新の DashScope Java SDK をインストールする必要があります。そうしないと、実行時エラーが発生する可能性があります:SDK のインストール。
リクエストの例
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;
import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
public class QwenImage {
static {
// シンガポールリージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
}
// API キーは北京リージョンとシンガポールリージョンで異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
// 環境変数を設定していない場合は、以下の行を static String apiKey="sk-xxx" に置き換えてください。
static String apiKey = System.getenv("DASHSCOPE_API_KEY");
public static void call() throws ApiException, NoApiKeyException, UploadFileException, IOException {
MultiModalConversation conv = new MultiModalConversation();
MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
.content(Arrays.asList(
Collections.singletonMap("text", "緑豊かな芝生の上で 3 匹の子犬がボールで遊んでいる、癒し系手描きポスター。鳥や星などの装飾要素が散りばめられている。メインタイトル「Come Play Ball!」が、太字の青い漫画風フォントで上部に目立つように表示されている。その下には、サブタイトル「Come [Show Off Your Skills]!」が緑色のフォントで表示されている。吹き出しには「Hehe, watch me amaze my little friends next!」というテキストが書かれており、遊び心のある魅力を加えている。下部には、「We get to play ball with our friends again!」という補足テキストが記載されている。カラーパレットは、新鮮な緑と青を中心に、明るいピンクと黄色のトーンでアクセントをつけ、陽気で子供らしい雰囲気を強調している。")
)).build();
Map<String, Object> parameters = new HashMap<>();
parameters.put("watermark", false);
parameters.put("prompt_extend", true);
parameters.put("negative_prompt", "低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、蝋人形のような外観、顔のディテールの欠如、過度の滑らかさ、AI のようなアーティファクト、混沌とした構図、ぼやけたまたは歪んだテキスト。");
parameters.put("size", "2048*2048");
MultiModalConversationParam param = MultiModalConversationParam.builder()
.apiKey(apiKey)
.model("qwen-image-2.0-pro")
.messages(Collections.singletonList(userMessage))
.parameters(parameters)
.build();
MultiModalConversationResult result = conv.call(param);
System.out.println(JsonUtils.toJson(result));
}
public static void main(String[] args) {
try {
call();
} catch (ApiException | NoApiKeyException | UploadFileException | IOException e) {
System.out.println(e.getMessage());
}
System.exit(0);
}
}
レスポンスの例
画像の URL は 24 時間後に有効期限が切れます。速やかに画像をダウンロードしてください。
{
"requestId": "5b6f2d04-b019-40db-a5cc-xxxxxx",
"output": {
"choices": [
{
"finish_reason": "stop",
"message": {
"role": "assistant",
"content": [
{
"image": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.png?Expires=xxx"
}
]
}
}
]
}
}
OpenAI Agents SDK との使用
Qwen-Image などの画像生成モデルは、DashScope ネイティブ API を通じて呼び出され、OpenAI 互換モード (compatible-mode) をサポートしていないため、OpenAI Agents SDK のエージェントの推論モデルとして直接使用することはできません。
OpenAI Agents SDK などのエージェントフレームワークでは、画像生成をツール (関数ツール) としてラップし、OpenAI 互換モードをサポートするテキストチャットモデル (qwen-plus など) をエージェントの推論コアとして機能させ、それをオーケストレーションさせることができます。例:
実行する前に、依存関係をインストールします:pip install openai-agents dashscope。
import os
import asyncio
import dashscope
from openai import AsyncOpenAI
from dashscope import MultiModalConversation
from agents import Agent, Runner, function_tool, OpenAIChatCompletionsModel
# 環境変数から Model Studio API キーを読み込む
# (または api_key="sk-xxx" に置き換える)
API_KEY = os.getenv("DASHSCOPE_API_KEY")
# シンガポールリージョン。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
dashscope.base_http_api_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"
# テキストチャットモデル (エージェントの推論コア) は、OpenAI 互換モードを介してアクセスされます
client = AsyncOpenAI(api_key=API_KEY, base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1")
# 画像生成をエージェントが呼び出すための関数ツールとしてラップする
@function_tool
def generate_image(prompt: str) -> str:
"""テキスト記述から画像を生成し、その URL を返します。prompt: 画像のテキスト記述。"""
rsp = MultiModalConversation.call(
api_key=API_KEY,
model="qwen-image-2.0-pro",
messages=[{"role": "user", "content": [{"text": prompt}]}],
result_format="message",
)
if rsp.status_code != 200:
return f"生成に失敗しました: {rsp.code} {rsp.message}"
return rsp.output.choices[0].message.content[0]["image"]
agent = Agent(
name="画像アシスタント",
instructions="あなたは画像生成アシスタントです。ユーザーが画像を求めたら、generate_image ツールを呼び出し、画像の URL をユーザーに返してください。",
model=OpenAIChatCompletionsModel(model="qwen-plus", openai_client=client),
tools=[generate_image],
)
async def main():
result = await Runner.run(agent, "芝生の上を走るコーギーを描いて")
print(result.final_output)
if __name__ == "__main__":
asyncio.run(main())
課金とレート制限
- 無料クォータと料金については、「モデル料金」をご参照ください。
- レート制限については、「Qwen-Image」をご参照ください。
- 課金の詳細:正常に生成された各画像に対して課金されます。失敗した呼び出しや処理エラーは、料金が発生したり、新規ユーザーの無料クォータを消費したりすることはありません。
エラーコード
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご確認ください。
よくある質問
Q: prompt_extend パラメーターは有効にすべきですか、それとも無効にすべきですか?
A: より多様な画像コンテンツを求め、モデルに詳細を追加させたい場合は、このオプションを有効にしてください (デフォルト)。画像のディテールをより厳密に制御する必要がある場合は無効にし、「Text-to-Image プロンプトガイド」を使用してプロンプトを最適化してください。
Q: qwen-image-2.0 シリーズの違いは何ですか?
A:
-
画像生成と編集の統合モデル:Text-to-Image と画像編集の両方をサポートします。
qwen-image-2.0-proとqwen-image-2.0-pro-2026-03-03:同等の機能を持ちます。プロ版シリーズは、よりプロフェッショナルなテキストレンダリング、より細かいリアルなテクスチャ、詳細なリアルなシーン、そしてより強力なセマンティックな忠実性を提供します。同期呼び出しのみをサポートします。qwen-image-2.0とqwen-image-2.0-2026-03-03:同等の機能を持ちます。高速化バージョンは、モデルのパフォーマンスと品質のバランスを取ります。同期呼び出しのみをサポートします。
Q: 画像ストレージのドメイン名ホワイトリストを取得するにはどうすればよいですか?
A: モデルによって生成された画像は OSS に保存されます。API は一時的な公開 URL を返します。このダウンロード URL のファイアウォールホワイトリストを設定するには、次の点にご注意ください:基盤となるストレージは動的に変更される可能性があります。このトピックでは、古い情報によるアクセス問題を避けるため、固定の OSS ドメイン名ホワイトリストは提供していません。セキュリティ管理要件がある場合は、アカウントマネージャーに連絡して最新の OSS ドメイン名リストを入手してください。
