Qwen-Image 3.0 Pro API

透過 GoEnhance 呼叫 Qwen-Image 3.0 Pro,用同一個端點完成文生圖與參考圖引導的編輯。送出提示詞,可選擇附上最多三個圖片 URL,取得 img_uuid 後輪詢或使用回呼。GoEnhance 提供的是獨立的存取管道,並非阿里巴巴的官方 API。
建立 API Key
無品牌標識的棚拍風格作品,代表 Qwen-Image 3.0 Pro API 的影像生成

生成與編輯共用一個端點

用提示詞生成影像

不傳 image_list 即為純文生圖。選擇支援的比例以及 1K 或 2K 輸出,也可以交給 ratio: auto 自動決定構圖。
細節豐富的單場景奇幻風景,代表文生圖生成

最多用三張參考圖編輯

在 image_list 中傳入一到三個可存取的圖片 URL。它們的順序決定提示詞如何指涉各個來源;每張參考圖都必須小於 10MB。
畫面一致的棚拍靜物,代表參考圖引導的影像編輯
送出前先驗證請求模式、比例、輸出等級與可選控制項。

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 回呼事件,直到工作成功或失敗,再保存產出或處理錯誤。
建立 API Key
既支援全新影像生成,也支援可控的參考圖工作流程。

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 文件最多重試三次回呼,每次嘗試逾時三秒。輪詢仍是實用的備援方式。

用 Qwen-Image 3.0 Pro API 開始打造

Qwen-Image 3.0 Pro API:價格與串接 | GoEnhance Open API