圖片編輯 API
編輯圖片、更換風格，或透過文字提示詞結合多張參考圖。共有 6 種模型支援透過 POST /v1/images/edits 傳入參考圖。
模型
以下所有模型均支援參考圖。請在 image_urls 中傳送圖片 URL；表格顯示了各模型支援的圖片數量上限。
| 模型與 API 模型 ID | 選項 | official-cheap 價格（預設） |
|---|---|---|
GPT Image 2openai/gpt-image-2 | 尺寸：1K, 2K, 4K最多 16 張參考圖片 | 每張 1K 圖片 $0.032official：$0.053 |
Nano Banana 2google/nano-banana-2 | 尺寸：1K, 2K, 4K最多 14 張參考圖片 | 每張 1K 圖片 $0.034official：$0.067 |
Nano Banana 2.1google/nano-banana-2.1 | 尺寸：1K, 2K, 4K最多 14 張參考圖片 | 每張 1K 圖片 $0.017official：$0.034 |
Nano Banana Progoogle/nano-banana-pro | 尺寸：1K, 2K, 4K最多 14 張參考圖片 | 每張 1K 圖片 $0.067official：$0.134 |
Qwen Image 2.1 Proqwen/qwen-image-2.1-pro | 尺寸：1K, 2K最多 3 張參考圖片 | 每張圖片 $0.035official：$0.038 |
Qwen Image 2.1 Turboqwen/qwen-image-2.1-turbo | 尺寸：1K, 2K最多 3 張參考圖片 | 每張圖片 $0.014official：$0.015 |
快速入門
- 建立 API 金鑰
在主控台中建立金鑰，並將其儲存為 MLMUX_API_KEY 環境變數。
建立 API 金鑰 - 發送請求
範例會將 Nano Banana Pro (google/nano-banana-pro) 發送至 https://api.mlmux.com/v1/images/edits。您可以將模型 ID 變更為上方表格中的任一模型。
- 讀取結果
回應會在 data 中列出圖片 URL。新增 "async": true 則可改為取得輪詢任務。
圖片 API 參考文件
curl https://api.mlmux.com/v1/images/edits \
-H "Authorization: Bearer $MLMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/nano-banana-pro",
"route_mode": "official-cheap",
"prompt": "Place the product on a sunlit marble counter and keep the label unchanged",
"image_urls": [
"https://your-cdn.example/product.jpg"
],
"resolution": "2K",
"aspect_ratio": "match_input_image",
"output_format": "png"
}'常見問題
圖片編輯該選擇哪款模型？
Nano Banana Pro 能良好處理複雜的多參考圖編輯。Nano Banana 2 與 2.1 成本較低，適合日常編輯；GPT Image 2 則最多支援 16 張參考圖。Qwen Image 2.1 Turbo 是成本最低的選擇。
編輯一張圖片的費用是多少？
圖片編輯的計費方式與同尺寸的生成圖片相同，在預設路由上每張約 $0.014 起（Qwen Image 2.1 Turbo）。
如何傳送要編輯的圖片？
可以在 image_urls 中傳入公開的 URL，或是透過 POST /v1/uploads 上傳檔案並使用返回的 URL。回應中會列出編輯後的圖片 URL。
失敗的請求會被計費嗎？是否有上限限制？
失敗的請求不會計費，預扣的點數將退回您的餘額。每個帳號最多可同時執行 60 個任務；如需提高上限，請寄信至 support@mlmux.com。