img_uuid 後輪詢或使用回呼。GoEnhance 提供的是獨立的存取管道,並非阿里巴巴的官方 API。Qwen-Image 3.0 Pro API
透過 GoEnhance 呼叫 Qwen-Image 3.0 Pro,用同一個端點完成文生圖與參考圖引導的編輯。送出提示詞,可選擇附上最多三個圖片 URL,取得
建立 API Key
生成與編輯共用一個端點
送出前先驗證請求模式、比例、輸出等級與可選控制項。
Qwen-Image 3.0 Pro API 參數
必填模型
把
model 設為 qwen-image-3-pro。提示詞
必須傳入 1 到 2000 個字元的文字提示詞。
畫面比例
可選
auto,或從 1:1 到 8:1 的 13 個文件化比例中擇一。輸出等級
把
image_size 設為 1K 或 2K;預設為 2K。參考圖
可選擇在
image_list 中傳入一到三個 URL 物件,每個都要小於 10MB。提示詞控制項
還可以選填負面提示詞、0 到 2147483647 之間的種子值,或
prompt_extend_mode。其中 agent 模式僅支援文生圖。費用由輸出等級加上每張參考圖的附加費構成。
Qwen-Image 3.0 Pro API 價格
1K 輸出
文件價格為每生成一張 1K 圖片 2.43 tokens($0.049)。
2K 輸出
文件價格為每生成一張 2K 圖片 4.85 tokens($0.097)。使用
ratio: auto 的請求依這個等級計費。參考圖附加費
每張參考圖額外增加 0.19 tokens($0.0039)。
1:8 與 8:1 這兩個比例只能用 1K 等級,也依 1K 等級計費。三步串接 Qwen-Image 3.0 Pro
1
1. 組裝並驗證
先決定要用文生圖還是參考圖編輯,寫好提示詞,驗證比例與圖片 URL,再加上授權標頭。
2
2. 送出並保存
帶上
model: qwen-image-3-pro 送出 POST 請求,並保存回傳的 img_uuid。 3
3. 處理最終狀態
輪詢
GET /api/v1/jobs/detail 或接收 HTTPS 回呼事件,直到工作成功或失敗,再保存產出或處理錯誤。既支援全新影像生成,也支援可控的參考圖工作流程。
Qwen-Image 3.0 Pro API 使用情境
產品視覺
生成可直接用於行銷活動的場景概念圖,或把已核准的產品參考圖編輯進新環境。
廣告素材變體
為橫幅廣告、付費投放與節慶創意測試產出由提示詞主導的視覺方向。
設計原型
在正式投入製作之前,先把文字版美術方向變成影像概念。
參考圖引導的風格改寫
用最多三張有先後順序的參考圖,引導構圖、主體細節或視覺處理方式。
在地化行銷活動
在維持串接契約不變的前提下,建立面向不同地區的場景變體。
內容產線
把非同步生成接進你應用程式裡的審核、複審、儲存與發佈系統。
解答價格、輸入、非同步交付以及阿里巴巴 API 搜尋意圖相關的問題。
Qwen-Image 3.0 Pro API 常見問題
Qwen-Image 3.0 Pro API 怎麼計費?
GoEnhance 文件列出的價格是:1K 輸出每張 2.43 tokens($0.049),2K 輸出每張 4.85 tokens($0.097),每張參考圖再加 0.19 tokens($0.0039)。
這是阿里巴巴的官方 API 嗎?
不是。Qwen 與阿里巴巴相關,而本頁描述的是 GoEnhance 提供的獨立 API 存取管道,並不代表雙方存在合作關係或取得對方背書。需要由阿里巴巴營運之 API 的開發者,請查閱阿里雲的官方文件。
同一個端點既能生成也能編輯影像嗎?
可以。不傳 image_list 就是文生圖;傳入一到三個參考圖 URL 就是編輯。該端點每次回傳一張生成影像。
支援哪些畫面比例?
文件列出的值為 auto、1:1、16:9、9:16、4:3、3:4、2:3、3:2、1:2、2:1、1:4、4:1、1:8 與 8:1。
提示詞擴寫是怎麼運作的?
預設的 direct 模式會直接使用原提示詞。agent 改寫得更徹底,但只對不帶 image_list 的文生圖請求有效。
API 會立刻回傳圖片嗎?
不會。送出成功後回傳的是 img_uuid。請輪詢工作詳情端點,或透過回呼事件取得最終結果。
回呼位址無法使用會怎樣?
如果你的端點沒有回傳 HTTP 200,依 GoEnhance 文件最多重試三次回呼,每次嘗試逾時三秒。輪詢仍是實用的備援方式。


