TL;DR
Qwen Image 3.0 以 Standard（qwen-image-3.0）與 Pro（qwen-image-3.0-pro）兩種變體統一支援文字轉圖像生成與參考圖引導編輯。從一段文字提示詞開始，選擇輸出尺寸，提交生成請求並立即保存輸出。進行編輯時，提供 1–3 張參考圖並明確說明需保留的要素。在 CometAPI 上，於部署示例呼叫前請先核實實際路由與相容的請求結構。
Key Takeaways
- Qwen Image 3.0 API 透過 Standard（qwen-image-3.0）與 Pro（qwen-image-3.0-pro）支援文字轉圖像與參考圖引導編輯；原生輸出為 PNG。
- 可透過 CometAPI 存取 Qwen Image 3.0 API。開發者可取得 API 金鑰、確認支援的端點，並將影像生成整合至應用。
- Qwen Image 3.0 API 在 CometAPI 上的價格自 $0.024/請求 起，相較於 Alibaba Cloud 新加坡區 Standard 輸出影像 $0.030/張、Pro 1K 輸出影像 $0.040/張 起。
- Qwen Image 3.0 影像編輯在原生 Alibaba Cloud API 上最多支援 3 張參考圖；生成每次請求可產生 1–6 張輸出。
- 整合 Qwen Image 3.0 API 時，開發者需在上線前核實供應商特定參數、驗證方式、計費單位與臨時影像 URL。
What Is the Qwen Image 3.0 API?
Qwen Image 3.0 API 可將文字指令轉為圖像，並可轉換所提供的照片或設計素材。支援情境包含多語海報、電商攝影、行銷活動模型稿、背景替換與合成圖編輯。
Qwen Image 3.0 Standard (qwen-image-3.0) 是以成本為導向的文字轉圖像與參考圖引導編輯基線方案。可優先用於高量工作流，如電商背景變體、社群視覺草稿與活動概念探索。例如先用 Standard 產出多個商品背景選項，檢視商品保真度後再挑選值得進一步精修的版本。
Qwen Image 3.0 Pro (qwen-image-3.0-pro) 同樣支援生成與參考圖引導編輯，並提供價格較高的原生 2K 輸出層級。可用於對品質敏感的交付，如活動主視覺、細節豐富的商品合成與宣傳海報。例如在需要更精細細節或版面時，用 Pro 測試入選概念，並與 Standard 結果比較後再決定是否投入較高預算。
如何選擇： 以 Standard 應對成本敏感的草稿與變體；針對要求較高的最終資產，用 Pro 在相同任務上測試，當可量化的提升足以支撐額外成本時再選用。無論哪種定位，都不能替代針對字體排印、產品保真度、物件數量或版面準確性的應用層級測試。
| Specification | Qwen Image 3.0 | Qwen Image 3.0 Pro |
|---|---|---|
| Model ID | qwen-image-3.0 | qwen-image-3.0-pro |
| Generation / editing | 皆可 | 皆可 |
| Reference images for editing | 1–3 | 1–3 |
| Generated images per request | 1–6 | 1–6 |
| Output format | PNG | PNG |
| Output pixel area | 512²–2048² | 512²–2048² |
| Recommended prompt length | 4,500 tokens | 4,500 tokens |
| Primary selection rationale | 具成本效率的吞吐量 | 高階輸出評估 |
What Parameters Does Qwen Image 3.0 API Support?
在 Alibaba Cloud 原生 OpenAI 相容介面中使用以下參數。於 CometAPI 僅在所選路由文件明確說明時，才加入供應商特定選項。
適用於兩種變體：qwen-image-3.0（Standard）與 qwen-image-3.0-pro（Pro）在 Alibaba Cloud 原生 OpenAI 相容介面上支援相同參數。透過 model 選擇變體；生成與編輯控制共用。這不代表輸出品質或定價相同，也不保證每條 CometAPI 路由都會暴露所有原生參數。
| Parameter | Type / example | Purpose |
|---|---|---|
| model | qwen-image-3.0 | 選擇 Standard 或 Pro |
| prompt | string | 指令與內容 |
| image | URL / base64 string or array | 編輯時的 1–3 張參考圖；生成則省略 |
| size | 1024x1024 | 輸出尺寸；支援時可自動 |
| n | integer 1–6 | 每次呼叫的輸出數量 |
| negative_prompt | string | 描述需避免的內容 |
| prompt_extend | boolean | 啟用提示詞改寫 |
| prompt_extend_mode | direct / agent | agent 模式僅支援 T2I |
| enable_thinking | boolean | 推理控制，受增強設定影響 |
| watermark | boolean | 選配浮水印 |
| seed | integer | 輔助重現性 |
對原生請求，輸出長寬比必須介於 1:8 與 8:1 之間。參考圖檔最大 10 MB，最短邊與最長邊介於 1–8,000 像素，且長短邊比不大於 10:1。對 Base64 輸入請使用 data URI。Thinking 需 prompt_extend=true；agent 增強僅支援文字轉圖像。
相容的影像請求需將生成欄位置於 JSON 頂層，且尺寸格式為 1024x1024。原生 DashScope 使用巢狀的 input/parameters，且常以 1024*1024 表示尺寸。未經轉換便在這些端點間複製請求，可能導致失敗。
How Do You Call Qwen Image 3.0 API with CometAPI?
以下步驟假設使用 Python 3、Bash 相容終端、具模型存取權限的 CometAPI 帳戶與足夠餘額。首次請求僅使用供應商示例中的 model 與 prompt 欄位。文件檢查日期為 2026 年 10 月 16 日；以下示例未在付費帳戶實際執行。
Create credentials
在 CometAPI 控制台建立伺服器端 API 金鑰。切勿在 Web 或行動端內嵌。
export COMETAPI_KEY="your_api_key"python -m pip install requests
Submit a minimal generation request
開發者可使用 CometAPI 文件化的影像生成路由存取 Qwen Image 3.0 API。在引入可選參數前，先從下方最小請求開始。
curl --fail-with-body https://api.cometapi.com/v1/images/generations \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen-image-3.0","prompt":"Premium skincare bottle on a stone pedestal, gentle studio lighting"}'
Save every returned image
將以下腳本保存為 generate.py，並執行 python generate.py。它會提交請求、處理 URL 或 Base64 影像結果，並將每張影像寫入本機。若回應包含任務資訊而非 data 陣列，它會停止而非猜測輪詢端點；請使用帳戶特定的非同步約定以取得完成結果。
import base64import osfrom pathlib import Pathimport requestsresponse = requests.post( "https://api.cometapi.com/v1/images/generations", headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"}, json={"model": "qwen-image-3.0", "prompt": "A sunny bookstore cafe, editorial photograph"}, timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images: raise RuntimeError(f"No synchronous images; inspect task/error fields: {list(result)}")for index, item in enumerate(images, 1): if item.get("url"): download = requests.get(item["url"], timeout=(15, 120)) download.raise_for_status() content = download.content elif item.get("b64_json"): content = base64.b64decode(item["b64_json"], validate=True) else: raise RuntimeError(f"Image {index} has no URL or Base64 payload") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"Saved {path}")
成功執行後會在本機產生影像檔。打開確認其可讀且符合所請求的場景。請在伺服器日誌中保存請求識別碼與使用量欄位，但不要記錄憑證。
How Do You Generate Multiple Images with Qwen Image 3.0?
在 Alibaba Cloud 原生介面上，將 n 設為 2–6 以獲得創意變體。對於 CometAPI，僅在確認所選路由支援後再啟用 n。請分別驗證每個返回資產；較大的 n 並不保證所有結果都能通過後續審查。
透過將 n 參數設為上限 6，可在單次請求中生成多張影像，適用於 qwen-image-3.0 與 qwen-image-3.0-pro，涵蓋文字轉圖像與影像編輯。預設僅為 1 張。
主要有兩種方式：若平台提供圖形介面選項可直接使用，或直接呼叫 API。
Generate multiple images using the API
- 打開 API 文件。
- 從 QwenCloud 主控台／CometAPI 取得 API 金鑰。
- 選擇
qwen-image-3.0或qwen-image-3.0-pro。 - 將
n設為想要的影像數量，介於1到6。 - 提交提示詞並保存返回的影像。
例如，設定 "n": 4 以請求同一提示詞的四種變體。
Python example
Here's a ready-to-adapt example using the OpenAI-compatible API.
from openai import OpenAIimport requestsclient = OpenAI( api_key="YOUR_QWEN_API_KEY", base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate( model="qwen-image-3.0-pro",
prompt=( "A cozy Japanese cafe on a rainy evening, " "warm glowing lights, cinematic photography, " "rich details, realistic reflections" ),
n=4,
size="1024x1024")# Save each generated image
for i, item in enumerate(result.data, start=1): response = requests.get(item.url) response.raise_for_status() with open(f"qwen_image_{i}.png", "wb")
as f:
f.write(response.content)print("Finished generating images!")
先安裝必要套件：
pip install openai requests
API 會為每個結果返回一個影像 URL。生成的影像 URL 具時效性，請及時下載保存。
Important settings
| Parameter | What it does |
|---|---|
n=4 | 生成四張輸出影像 |
model="qwen-image-3.0-pro" | 選擇 Pro 模型 |
size="1024x1024" | 請求正方形影像 |
seed=12345 | 有助提升結果的可重現性 |
negative_prompt | 排除不想要的視覺元素 |
每次請求的最大輸出數量為 6。請注意，請求更多影像會增加生成成本。
一個重要差異：n=4 表示同一提示詞的四種變體。若你需要四個不同提示詞，應分別提交請求或以程式自動化迭代你的提示詞清單。
How Do You Edit Images with Qwen Image 3.0?
編輯請求會將 1–3 張參考圖與指令結合。請同時說明欲達成的轉換與必須保持不變的要素——例如產品標籤、顏色、機位或包裝幾何形狀。
下一個示例使用 Alibaba Cloud 憑證與其用於編輯的 JSON 影像欄位。建立區域性的 Model Studio 金鑰、取得工作區 ID，並設定對應端點。請勿在此請求中使用 CometAPI 金鑰替代。
export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"
下方參考圖來自官方 API 示例。這是一張輸入影像，並非本文產出的結果。
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0",
"prompt": "Change the outfit to a charcoal business suit in a cafe. Preserve the face and hairstyle.",
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"],
"size": "1024x1024",
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())
原生相容端點在 /images/generations 上使用 JSON，而非在 /images/edits 使用 multipart 上傳。它不支援遮罩或串流。請讀取返回的 data 陣列，並用上文相同的下載迴圈保存每個 URL。
若使用兩張參考圖，請在 image 陣列中放入兩個 URL，並在提示詞中說明其角色（例如：第一張取產品、第二張取室內場景）。Qwen Image 3.0 系列最多僅接受三張參考圖；如需更大量的來源，請改用其他模型或前處理工作流。
How Much Does Qwen Image 3.0 API Cost?
Qwen Image 3.0 API 的價格因模型變體、輸出解析度與供應商而異。下表在原有 Alibaba Cloud 新加坡區比較的基礎上，補充評審者附件中的 CometAPI 費率。附件以每張影像的美元計價，並對四種模型／解析度組合提供 20% 折扣。這些費率未經以實際帳單再驗證；在生產使用前請確認適用的費率表。
| Pricing item | Alibaba Cloud Standard | Alibaba Cloud Pro | CometAPI |
|---|---|---|---|
| Input reference image | $0.003/image | $0.003/image | $0.0024/image（適用於 Standard 與 Pro） |
| Successful 1K output | $0.030/image | $0.040/image | Standard：$0.0240/image；Pro：$0.0320/image |
| Successful 2K output | $0.030/image | $0.075/image | Standard：$0.0240/image；Pro：$0.0600/image |
| 100 successful 1K outputs | $3.00 | $4.00 | Standard：100 張輸出 $2.40；Pro：100 張輸出 $3.20* |
| 1,000 successful 2K outputs | $30.00 | $75.00 | Standard：1,000 張輸出 $24.00；Pro：1,000 張輸出 $60.00* |
| Billing unit | Input/output image | Input/output image | 依據附件費率表，按可計費的輸入參考圖與成功輸出影像計費 |
| CometAPI output-price discount | 20% at 1K and 2K | 20% at 1K and 2K | 輸入與輸出費率為對應官方影像價格的 80%，依據所附表格 |
*以上數量示例僅涵蓋輸出影像：100 張 Standard 1K 影像成本 $2.40，100 張 Pro 1K 影像成本 $3.20；1,000 張 Standard 2K 影像成本 $24.00，1,000 張 Pro 2K 影像成本 $60.00。若為編輯，另加每張可計費輸入參考圖 $0.0024。失敗作業規則、稅費與帳戶特定調整不在此列。
依據所提供的輸入與輸出影像單價，可用以下方式估算兩種供應商的影像費用：
Total cost = (billable reference images × input-image price) + (successful outputs × output-image price).
例如：一個作業計費兩張輸入參考圖且成功產生三張 Standard 1K 輸出，Alibaba Cloud 影像費用為 (2 × $0.0030) + (3 × $0.0300) = $0.0960；對應的 CometAPI 影像費用為 (2 × $0.0024) + (3 × $0.0240) = $0.0768，係依據所提供的費率。
CometAPI 針對兩種變體的輸入參考圖皆收取 $0.0024/張。輸出價格為 Standard 在 1K 或 2K 皆為 $0.0240/張、Pro 在 1K 為 $0.0320/張、2K 為 $0.0600/張。附件所列每項輸入與輸出費率皆低於對應官方價格 20%。在可計費影像數量相同的情況下，影像費用因此低 20%；其他費用或帳戶條款可能影響最終帳單。
進行生產級預算時，請核實所選變體、影像解析度、參考圖費用、每次請求的輸出張數與適用的帳戶折扣，再估算總使用成本。
How Do You Handle Qwen Image 3.0 API Errors?
| Symptom | Likely cause | Action |
|---|---|---|
| 401/403 | 金鑰無效或區域錯誤 | 檢查憑證、權限與部署區域 |
| 400 invalid image | 參考圖數量／型別不符 | 使用 1–3 張、有效 URL/Base64、受支援格式 |
| 400 invalid size | 不支援的面積／長寬比或分隔符 | 依端點規範正規化尺寸 |
| Unexpected JSON | 端點錯誤或回應結構不符 | 記錄回應欄位並調整解析器 |
| Expired image URL | 未在有效期內保存影像 | 生成後立即下載並存檔 |
| Unexpected bill | 未計入參考圖或輸出層級 | 使用影像使用量欄位與最新費率表 |
| Inconsistent brand text | 生成限制所致 | 加入審核關卡或於後製覆蓋文字 |
FAQ
我應該在逾時後重試 Qwen Image 3.0 請求嗎？
用戶端逾時不代表生成已停止。請保留請求或任務識別碼，查閱供應商的作業歷史或狀態 API，先確認是否已有輸出再重送。盲目重試可能造成重複作業與額外費用。對暫時性失敗使用有界重試，並遵循供應商的冪等性指引（若有）。
如何在 Qwen Image 3.0 使用本機參考圖？
對原生相容介面，請讀取檔案位元組、以 Base64 編碼，並加上如 data:image/png;base64, 的 data URI 前綴。將完整字串放入 image。Base64 輸入仍須符合影像大小與尺寸限制；本機檔案路徑並非服務可擷取的 URL。
如何透過 OpenAI SDK 傳遞 Qwen 特定選項？
請將標準影像欄位放在 SDK 既有參數中，並把 Model Studio 擴充欄位（例如 image 與 prompt_extend）置於 extra_body。原始 HTTP 請求則將這些欄位直接置於 JSON 頂層。此作法適用於原生相容介面；在轉發供應商特定選項給 CometAPI 前，請先確認所選路由。
當 Qwen Image 3.0 返回少於請求數量的影像時該怎麼辦？
先保存成功的輸出並記錄實際數量。對 Alibaba Cloud 原生計費，輸出費用依成功生成的影像收取。若仍需更多資產，請在檢查回應與使用紀錄後，只請求缺少的數量；CometAPI 計費需依其帳戶條款對帳。
Conclusion
Qwen Image 3.0 對需要在同一模型家族內同時進行生成與參考驅動編輯的團隊而言相當實用。以 Standard 作為成本導向基線，針對要求更高的 2K 或創意任務以 Pro 測試，並以「可被接受的輸出成本」評估，而非僅看「每次請求價格」。先從最小生成呼叫開始、持久化其輸出，再依正確的供應商契約加入編輯或多輸出。妥善區隔憑證與請求結構、明確處理錯誤，並依選定的費率表對齊影像用量與費用。