Qwen-Image シリーズ
Alibaba の通義画像モデルで、全 2 モデルです。OpenAI 互換エンドポイント /v1/images/generations で呼び出し、テキストからの画像生成と画像編集のどちらもこのエンドポイントを使います。
モデルの選び方
2 モデルのパラメーターはまったく同じです。Pro は上位版で、文字の描画と画像の質感が優れています。
qwen/qwen-image-3.0-pro上位版qwen/qwen-image-3.0標準版リアルタイム価格はモデルページ を参照してください。
他のシリーズとの違い
URL の有効期限：URL に含まれる Expires パラメーターは生成から 24 時間後です。長期間使う場合は速やかにダウンロードして保存し直してください。URL をそのままデータベースに保存しないでください。
テキストから画像生成
Python
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
resp = client.images.generate(
model="qwen/qwen-image-3.0-pro",
prompt="白いテーブルの上に置かれた赤いリンゴと、その横の「OfoxAI」と書かれたカード",
size="1024x1024",
)
# 返るのは一時 URL のため、24 時間以内にダウンロードする
urllib.request.urlretrieve(resp.data[0].url, "output.png")サイズと枚数
n の上限は 6 です。実測では 2560x1440 も使えました。所要時間は 1024×1024 で約 10〜60 秒、2560×1440 で約 60 秒、画像編集で約 50〜100 秒です。クライアントのタイムアウトは 300 秒以上に設定することを推奨します。
画像編集と複数画像の参照
input_images を使い、最大 3 枚です。image フィールドは使わず、/v1/images/edits にも対応していません。Python
import base64
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
with open("apple.jpg", "rb") as f:
ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
resp = client.images.generate(
model="qwen/qwen-image-3.0-pro",
prompt="リンゴを紫色に変え、それ以外はそのままにする",
extra_body={"input_images": [ref]},
)
urllib.request.urlretrieve(resp.data[0].url, "apple_purple.png")input_imagesは配列で、各要素は画像の URL またはdata:image/...;base64,で始まる文字列です。枚数は 1〜3 枚で、3 枚を超えると 400 を返します。imageは Seedream 専用のフィールドで、Qwen-Image は非対応です。- 画像編集で
sizeを省略すると、実測では 2048×2048 で出力され、元画像と一致しない場合があります。サイズを保ちたい場合は明示的に指定してください。
その他のパラメーター
negative_prompt（含めたくない内容）と prompt_extend（モデルがプロンプトを自動で拡張するかどうか）は、実測で正常に指定できました。パラメーターの定義は Alibaba Cloud Model Studio（百錬）公式ドキュメント を参照してください。
よくあるエラー
エラーメッセージ中の qwen-image-3.0-distill は上流の内部モデル名です。呼び出しには引き続きこのページに記載のモデル ID を使ってください。
エラーメッセージの原文
Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requests. Got area=10000 (width=100, height=100).
Input should be less than or equal to 6: parameters.n
Model 'qwen-image-3.0-distill' supports 0~3 image content items. Got 4 image items. (0 images = T2I mode, 1~3 images = I2I mode)よくある質問
Qwen-Image で b64_json ではなく url が返るのはなぜですか？
Qwen-Image が返すのは Alibaba Cloud OSS の一時的な画像 URL（data[].url）で、base64 ではありません。URL は 24 時間後に失効するため、取得したらできるだけ早くダウンロードして保存し直してください。
Qwen-Image で画像を編集するには？
/v1/images/generations で input_images（配列、1〜3 枚。各要素は画像の URL または data:image で始まる base64）を指定します。image は Seedream 用のフィールドで、Qwen-Image は非対応です。/v1/images/edits にも対応していません。
Qwen-Image で Image area must be between 262144 and 6553600 pixels エラーが出るのはなぜですか？
サイズの総ピクセル数は 512x512〜2560x2560 の範囲内にする必要があります。たとえば 100x100 は小さすぎ、3000x3000 は大きすぎます。1024x1024、2048x2048、2560x1440 などに変更してください。
Qwen-Image は 1 回で最大何枚生成できますか？
n の上限は 6 で、7 以上を指定すると 400 を返します。それ以上必要な場合はリクエストを分けて送ってください。
Qwen-Image の画像 URL が開けなくなったのはなぜですか？
URL に含まれる Expires パラメーターは生成から 24 時間後で、期限が過ぎるとダウンロードできず、再生成するしかありません。URL を取得したら速やかにダウンロードし、自前のストレージに保存してください。