Skip to Content
模型用法Qwen-Image

Qwen-Image 系列

阿里巴巴的通義圖像模型，共兩款，透過 OpenAI 相容介面 /v1/images/generations 呼叫，文生圖與改圖皆使用此端點。

模型選擇

兩款參數完全相同。Pro 為高階版本，文字渲染與畫面質感更佳。

模型 ID（呼叫時原樣複製）
Qwen-Image 3.0 Proqwen/qwen-image-3.0-pro高階版
Qwen-Image 3.0qwen/qwen-image-3.0標準版

即時價格請參閱模型頁 。

與其他系列的差異

重點回傳圖片連結而非 base64，連結在 24 小時後失效。
Qwen-ImageGPT Image、Seedream 等
回傳data[].url，阿里雲 OSS 的臨時連結data[].b64_json
參考圖欄位input_imagesSeedream 用 image
/v1/images/edits不支援GPT Image 支援

連結有效期限：連結中的 Expires 參數為生成後 24 小時。如需長期使用，請及時下載並另行儲存，不要將連結直接寫入資料庫。

文生圖

qwen_image.py
import urllib.request
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
 
resp = client.images.generate(
    model="qwen/qwen-image-3.0-pro",
    prompt="白色桌面上的一顆紅蘋果，旁邊一張卡片寫著「OfoxAI」",
    size="1024x1024",
)
 
# 回傳的是臨時連結，請在 24 小時內下載
urllib.request.urlretrieve(resp.data[0].url, "output.png")

尺寸與張數

重點總像素須介於 512×512 至 2560×2560 之間；n 最大為 6。
參數取值說明
size寬x高總像素 262,144（512×512）至 6,553,600（2560×2560），超出範圍會回傳 400
不傳 size—實測輸出 2048×2048
n1–6單次回傳多個連結；傳入 7 以上會回傳 400

實測 2560x1440 可用。耗時方面，1024×1024 約 10 至 60 秒，2560×1440 約 60 秒，改圖約 50 至 100 秒。用戶端逾時建議設定為 300 秒以上。

改圖與多圖參考

重點參考圖使用 input_images，最多 3 張；不使用 image 欄位，也不支援 /v1/images/edits。
qwen_edit.py
import base64
import urllib.request
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/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（是否由模型自動擴寫提示詞）實測可正常傳入。參數定義見阿里雲百煉官方文件 。

常見錯誤

錯誤原文（節錄）原因處理方式
Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requests尺寸過小或過大調整至範圍內，如 1024x1024、2560x1440
Input should be less than or equal to 6: parameters.nn 超過 6調整為 6 以內；更多圖片請分批請求
supports 0~3 image content items. Got 4 image items.參考圖超過 3 張減少至 3 張以內
does not support the /v1/images/edits endpoint呼叫了改圖端點改用 /v1/images/generations 的 input_images
參考圖未生效使用了 image 欄位改用 input_images
圖片連結無法存取連結已超過 24 小時有效期限重新生成；取得連結後請及時下載並另行儲存

錯誤原文中的 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 為什麼回傳的是 url 而不是 b64_json？

Qwen-Image 回傳的是阿里雲 OSS 的臨時圖片連結（data[].url），不是 base64。連結 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 一次最多生成幾張？

n 最多 6，傳入 7 以上會回傳 400。如需更多，請分批請求。

Qwen-Image 的圖片連結打不開了？

連結中的 Expires 參數為生成後 24 小時，過期後無法下載，只能重新生成。取得連結後請及時下載並儲存至自有儲存空間。

最後更新於
Seedream（豆包）MAI Image