Qwen-Image 3.0 API

透過 GoEnhance 使用 qwen-image-3 模型生成或編輯單張圖片。只給提示詞即為文字生圖,附上一到三個參考圖網址即為圖片編輯。GoEnhance 提供的是獨立的 API 存取服務,並非阿里巴巴官方 API,也不是阿里巴巴的關係企業。
建立 API Key
代表 Qwen-Image 3.0 API 生成能力的抽象攝影棚場景

把生成與編輯整合到同一套流程

一個端點,兩種模式

向 /api/v1/images/generations 發送 POST 請求,並設定 model: qwen-image-3。只傳提示詞即為文字生圖;傳入一到三個可存取的參考圖網址即為編輯。每次請求會回傳一張圖片。
同一個攝影棚場景中的玻璃藝術品,象徵圖片生成與編輯

天生非同步的結果回傳

提交成功後會回傳 img_uuid。請將它保存下來,接著輪詢 GET /api/v1/jobs/detail,或提供可公開存取的 HTTPS 回呼網址,以接收 processing、success 與 failed 的狀態變更。
沒有品牌標識的資料走廊與連續光軌,象徵非同步交付
提交生成或編輯任務前,先核對文件列出的欄位。

Qwen-Image 3.0 API 參數

模型 ID

將 model 設為固定值 qwen-image-3。

提示詞

填入 1–2000 個字元,描述想要的畫面或編輯效果。

長寬比

使用 auto,或在 1:1 到 1:8、8:1 之間挑選文件列出的比例。

輸出等級

選擇 1K 或 2K;文件中的預設值為 2K。

參考圖

可選擇傳入一到三個圖片網址,每張小於 10 MB,用於編輯。

提示詞控制項

可選擇設定負向提示詞、隨機種子,以及 direct 或 agent 提示詞擴寫模式。
計費由輸出費用加上參考圖附加費組成。

Qwen-Image 3.0 API 價格

出圖價格

每張 1K 或 2K 輸出消耗 1.75 點數,相當於每張生成圖片 $0.035。

參考圖附加費

每張參考圖額外消耗 0.19 點數,相當於每張參考圖 $0.0039。

任務計費

帶兩張參考圖的請求消耗 2.13 點數:1.75 + (2 × 0.19)。

串接 Qwen-Image 3.0 API

1

建立請求

在 Authorization 標頭中帶入 API 憑證,接著 POST 一個含有 model 與 prompt 的 JSON 請求主體。只有需要時才加上比例、圖片尺寸或參考圖網址。
2

保存任務 ID

確認回傳 code: 0,並保存回傳的 img_uuid。點數不足與驗證失敗的回應要當成失敗處理,而不是圖片結果。
3

確認任務完成

輪詢任務詳情端點,或使用可公開存取的 HTTPS 回呼。任務進入 success 之後才可採用產出物;failed 狀態必須明確處理。
建立 API Key
不必自建模型推論服務,就能把圖片生成與可控編輯加入正式流程。

開發者應用情境

產品視覺

用結構化提示詞產出可直接投放的產品概念圖。

創意變化版本

為廣告、社群貼文與到達頁產生新的視覺方向。

參考圖導引編輯

在保留提示詞意圖的前提下,改造一到三張提供的參考圖。

在地化行銷素材

依據在地化創意簡報,產出針對特定市場的視覺概念。

素材產線

在自動化內容流程中,把非同步生成任務排入佇列。

設計原型

在最終製作之前,先探索構圖、材質與配色的想法。
價格、輸入與串接相關常見問題的解答。

Qwen-Image 3.0 API 常見問題

Qwen-Image 3.0 API 的端點是什麼?

向 https://api.goenhance.ai/api/v1/images/generations 發送 POST 請求,並設定 model: qwen-image-3。

Qwen-Image 3.0 API 怎麼計費?

文件中的出圖價格為 1.75 點數,也就是 $0.035,1K 與 2K 同價。每張參考圖額外消耗 0.19 點數,也就是 $0.0039。

這個 API 可以編輯既有圖片嗎?

可以。加上 image_list,帶入一到三個可存取的圖片網址,每張小於 10 MB。純文字生圖時省略此欄位即可。

支援哪些長寬比?

此 API 支援 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。其中 1:8 與 8:1 的輸出僅限 1K 等級。

回呼是怎麼運作的?

提供一個可公開存取的 HTTPS 回呼網址。GoEnhance 會依任務詳情回應的結構推送 processing、success 與 failed 變更。回呼未回傳 200 時最多重試三次,每次逾時時間為三秒。

這是阿里巴巴官方 API 嗎?

不是。Qwen 與阿里巴巴相關,但此端點是由 GoEnhance 獨立提供,並不代表與阿里巴巴有合作關係或獲得其背書。若需要阿里巴巴自行營運的服務,請參閱阿里雲的官方文件。

開始用 Qwen-Image 3.0 打造應用

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