Qwen Image 3.0 API
Alibaba の Qwen Image 3.0 は、Standard と Pro のテキストから画像と画像編集のエンドポイントで、柔軟なアスペクト比、1K/2Kの出力、自然言語による指示の理解を備えています。
Qwen Image 3.0 は、Standard と Pro のテキストから画像と編集のエンドポイントを提供します。安定した1K/2Kの生成と編集には Standard 階層を、より高精細な出力には、解像度に応じた料金の Pro を選んでください。
/filters:quality(82)/examples/97938534229240bdb8457c6ae2c22e1b/1-1041bd7755e3.webp)
概要
Qwen Image 3.0 APIについて
Qwen Image 3.0でできること、Alibabaのモデルラインナップにおける位置づけ、そして多くのチームに選ばれる理由。
Qwen Image 3.0はAlibabaの画像生成・編集モデルで、WaveSpeedAIのREST APIから利用できます。Alibaba の Qwen Image 3.0 は、Standard と Pro のテキストから画像と画像編集のエンドポイントで、柔軟なアスペクト比、1K/2Kの出力、自然言語による指示の理解を備えています。
Qwen Image 3.0 は、Standard と Pro のテキストから画像と編集のエンドポイントを提供します。安定した1K/2Kの生成と編集には Standard 階層を、より高精細な出力には、解像度に応じた料金の Pro を選んでください。
WaveSpeedAIのQwen Image 3.0ファミリーには、Text-To-Image, Image-To-Imageのワークフローをカバーする4個のRESTエンドポイントがあります。各バリアントには、それぞれ独自の料金、パラメーター、作例があります。入力の種類と本番環境の制約に合うものを選ぶか、同じAPIキーで複数を呼び出して、多段階のパイプラインを組み立ててください。
WaveSpeedAIの他の1,000以上のAIモデルと同じAPIキー、請求アカウント、レート制限の枠組みでQwen Image 3.0を実行できます。ベンダーごとの設定も、プロバイダーごとのSDKも、ベンダーごとのレート制限も不要です。1つの連携で、テキストから画像、テキストから動画から、音声合成、3D生成、高画質化、編集まで、すべてカバーできます。
エンドポイント
Qwen Image 3.0のAPIエンドポイント一覧
WaveSpeedAIで現在利用可能なQwen Image 3.0のエンドポイントは4個です。ワークフローに合ったバリアントを選んでください。
/filters:quality(82)/media/images/1785949826547283917_F8QZ8hqB.webp)
Qwen Image 3.0 Text To Image
Qwen Image 3.0 Text to Image is a high-quality image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785949851816447753_YuENW5PZ.webp)
Qwen Image 3.0 Edit
Qwen Image 3.0 Edit is a high-quality image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785950638933780388_UpyHQ09J.webp)
Qwen Image 3.0 Pro Text To Image
Qwen Image 3.0 Pro Text-to-Image is a professional-grade image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785950659359092904_wW4uENW5.webp)
Qwen Image 3.0 Pro Edit
Qwen Image 3.0 Pro Edit is a professional-grade image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
作例
Qwen Image 3.0の実力を見る
Qwen Image 3.0 APIで実際に生成された出力です。動画にカーソルを合わせるとプレビュー、クリックすると原寸のビューアで開きます。
使い方
Qwen Image 3.0 APIの使い方
登録から生成完了まで4ステップ。Python、Node.js、cURLの完全なサンプルは、下のAPIセクションにあります。
- 01
APIキーを取得
WaveSpeedAIのアカウントに登録し、ダッシュボードからAPIキーをコピーします。新規アカウントには無料のスタータークレジットが付くので、課金が始まる前にプレイグラウンドを数十回実行できます。
- 02
予測を送信
入力をJSONとしてhttps://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-imageにPOSTします。エンドポイントはすぐに予測IDを返します。生成は非同期なので、推論中に接続を開いたままにする必要はありません。
- 03
完了までポーリング
https://api.wavespeed.ai/api/v3/predictions/{request_id}/resultにGETします。completedなら出力を返し、failed、cancelled、timeout、deletedならエラーで停止し、それ以外のステータスの間はポーリングを続けます。
- 04
出力URLを読み取る
ステータスが"completed"になったら、data.outputs[0]からURLを読み取ります。URLは、WaveSpeedAIのCDN上にある生成されたメディアを指します。呼び出したQwen Image 3.0のバリアントに応じて、画像、動画、音声、3Dファイルのいずれかです。
活用例
Qwen Image 3.0で作れるもの
開発者やクリエイターがQwen Image 3.0 APIでよく使うワークフロー。
Standard のテキストから画像生成
alibaba/qwen-image-3.0/text-to-image は、自然言語のプロンプトから、柔軟なアスペクト比と、1Kまたは2Kの解像度階層で画像を作成します。
制作向けの Pro 画像生成
alibaba/qwen-image-3.0-pro/text-to-image は、精細なビジュアル制作、プロンプトへの追従、より高精細な制作用の出力のための、Pro の生成階層です。
自然言語による画像編集
Standard と Pro の編集エンドポイントは、1〜3枚の参照画像を、求められたビジュアルの文脈を保ちながら、自然言語の指示で変換します。
解像度を意識したクリエイティブのワークフロー
生成や編集の前に、1Kか2Kの出力とアスペクト比を選び、マーケティング、商品、ポートレート、クリエイティブの納品ワークフローに合わせられます。
コツ
Qwen Image 3.0のプロンプトのコツ
Qwen Image 3.0からより良い出力を得るための実践的なアドバイス。本番のパイプラインで画像モデル全般に通用するパターンに基づいています。
- 01
被写体だけでなく、ライティング、構図、スタイルも記述する
「猫」から一歩進んで、「窓辺のトラ猫、午後の柔らかな光が差し込む、浅い被写界深度、シネマティックな35mmの構図」と書きましょう。被写体、シーン、ライティング、カメラの表現という組み合わせは、画像モデルの学習データから最もうまく引き出せるプロンプトの型です。
- 02
アーティスト名ではなくスタイルの表現を使う
「エディトリアルフォトグラフィ風」や「スタジオでの商品撮影、白いシームレスな背景」のほうが、曖昧な「高品質、傑作」といった定型文より優れており、商用の作品で存命のアーティストの名前を挙げることによる、法的・ライセンス上の懸念も避けられます。
- 03
解像度とアスペクト比を明示する
デフォルトに頼らないでください。目標のアスペクト比(1:1、4:3、16:9)と解像度を、最初に設定します。後からのトリミングやアップスケールでは、最初の生成でモデルが正しく配置できたはずの精細さが失われます。
- 04
引き直す前に、固定したシードで試行する
シードを固定して、プロンプトの要素を1つずつ変えます。変更のたびにランダムなシードで引き直すよりはるかに速く、プロンプトの編集ごとの原因と結果を切り分けられ、より少ない生成回数で目標の画像にたどり着けます。
- 05
修正には、全体の再生成ではなく編集エンドポイントを使う
ベースの画像を一度生成し、その後モデルの edit / inpaint エンドポイントで、文字、ライティング、個々の被写体といった特定の要素を磨きます。編集は、ベースで気に入っていた部分をすべて保ち、全体を再生成するより1回あたりのコストも抑えられます。
料金
Qwen Image 3.0 APIの料金
料金は出力ごとです。最終的な請求額は、各バリアントのプレイグラウンドで設定するパラメーター(解像度、長さ、出力数、参照入力)に応じて変わります。
| エンドポイント | タイプ | 最低料金 |
|---|---|---|
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | image-to-image | $0.03 |
| alibaba/ | text-to-image | $0.04 |
| alibaba/ | image-to-image | $0.04 |
API
Qwen Image 3.0 APIを呼び出す
wavespeed.ai/accesskeyでAPIキーに登録し、RESTで予測を送信します。プレイグラウンドでは、入力の組み合わせに応じて、そのまま貼り付けられるサンプルが生成されます。
POSThttps://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)比較
Qwen Image 3.0と他モデルの比較
WaveSpeedAI上の類似モデルではなくQwen Image 3.0を選ぶべきケース。
Qwen Image 3.0 vs Seedream 5 Pro
Seedream 5 Pro は、デザインの理解、複数参照の編集、出力形式の制御を重視しています。Qwen Image 3.0 は、1Kと2Kの階層で、自然言語による生成と編集ができる、Standard/Pro のシンプルな構成です。
Qwen Image 3.0 vs Qwen Image 2.0
Qwen Image 2.0 は、Qwen ファミリーの前世代の生成・編集の構成です。Qwen Image 3.0 は、専用の Alibaba の Standard と Pro のエンドポイントを使い、生成と編集の挙動が更新されています。
FAQ
Qwen Image 3.0 API — よくある質問
料金、ライセンス、連携など、WaveSpeedAIでQwen Image 3.0を実行する際のよくある質問。
Qwen Image 3.0 APIとは何ですか?
Qwen Image 3.0は、Alibabaの画像生成モデルで、WaveSpeedAI上でREST APIとして提供されています。Alibaba の Qwen Image 3.0 は、Standard と Pro のテキストから画像と画像編集のエンドポイントで、柔軟なアスペクト比、1K/2Kの出力、自然言語による指示の理解を備えています。プログラムから呼び出すことも、上にリンクされたプレイグラウンドで試すこともできます。
Qwen Image 3.0 APIはどう呼び出しますか?
WaveSpeedAIのアカウントに登録し、/accesskeyからAPIキーをコピーして、入力をJSONとしてhttps://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-imageにPOSTします。エンドポイントは予測IDを返します。結果のエンドポイントを約2秒ごとにポーリングし、長時間かかるタスクでは間隔を広げ、終端ステータスになったら停止してください。本番運用向けのPython / Node.js / cURLのサンプルは上にあります。
Qwen Image 3.0 APIの料金はいくらですか?
Qwen Image 3.0は$0.03からです。実際の料金は、設定するパラメーター(解像度、長さ、出力数、参照入力)に応じて変わります。プレイグラウンドの「生成」ボタンの横に表示されるリアルタイムの料金プレビューで、現在の入力での正確な料金を確認できます。
Qwen Image 3.0にはどのバリアントがありますか?
WaveSpeedAIでは、4個のQwen Image 3.0エンドポイントが利用可能です:alibaba/qwen-image-3.0/text-to-image, alibaba/qwen-image-3.0/edit, alibaba/qwen-image-3.0-pro/text-to-image, alibaba/qwen-image-3.0-pro/edit。各バリアントには、専用のプレイグラウンドページと料金があります。
Qwen Image 3.0の出力を商用利用できますか?
商用利用の権利は、Alibabaのモデルライセンスに従います。Alibabaのほとんどのモデルは出力の商用利用を認めています。具体的なライセンスの概要は各モデルのプレイグラウンドページで、プラットフォーム全体の条件はWaveSpeedAIの利用規約でご確認ください。
なぜ直接ではなくWaveSpeedAIでQwen Image 3.0を使うのですか?
Qwen Image 3.0と、他のプロバイダーの1,000以上のAIモデルを、1つのAPIキー、1つの請求アカウントで利用できます。ベンダーごとのSDK設定も、個別のレート制限も、ベンダーごとの連携コードの書き直しも不要です。料金は、通常Alibabaの直接のAPIと同等かそれ以下です。
提供元
Alibabaについて
WaveSpeedAIにおけるQwen Image 3.0と、Alibabaのモデルラインナップ全体を手がけるチーム。
Alibaba の Tongyi Lab は、動画モデルの Wan ファミリーと、LLM の Qwen ファミリーを開発しています。Wan は、オープンウェイトで公開されていること、幅広いバリアント(テキストから動画、画像から動画、リファレンスから動画、video-edit、video-extend、image-edit、text-to-image)を網羅していること、多言語のプロンプトにわたってモーションの安定性とプロンプトへの追従性に一貫して強みがあることが特長です。
WaveSpeedAIでQwen Image 3.0を使った開発を始めよう
登録時に無料のスタータークレジットを進呈。Alibabaをはじめ、あらゆるプロバイダーの1,000以上のAIモデルを、1つのAPIキーで。
/filters:quality(82)/examples/e699bbebd6bdb91b0997ad00a6db5927/1-a0b53b852c48.webp)
/filters:quality(82)/examples/861c63aed61c2671fa3f2cc5446a7fc9/1-9313861ab37e.webp)
/filters:quality(82)/examples/aa6aaaad4738a37e20a331f53432e66e/1-3808e66eb793.webp)
/filters:quality(82)/examples/b01c4177aa64d5a63f66b59f28e734f2/1-f943c79cfc64.webp)