編輯圖片

POST/v1/images/edits

上傳參考圖並根據提示詞編輯圖片。

授權

bearerAuth

授權Bearer <token>

使用平台 API Key，格式為 Authorization: Bearer your-api-key。

傳遞位置: header

請求主體

multipart/form-data

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

model*string

平台模型 ID。

prompt*string

圖片編輯指令，始終開啟提示詞增強。按 Unicode 字元計，不含前後空白；內容不能全為空白。

長度1 <= length <= 32000

n?integer

生成圖片數量。

範圍1 <= value <= 10

預設值1

size?string

auto 或寬x高，預設 auto。自訂面積為 655,360–20,000,000 像素，長寬比為 1:3–3:1；指定寬高時省略 aspect_ratio 和 area。

預設值"auto"

aspect_ratio?string

預設 auto，由增強後的提示詞決定；編輯時結合參考圖。也可傳 X:Y，X、Y 為 1–300 的整數，比值為 1:3–3:1。僅在 size 省略或為 auto 時使用。

area?string

面積檔位，預設 4K。僅在 size 省略或為 auto 時使用，實際寬高見 data[].size。

可用值

"1K"
"2K"
"4K"

output_format?string

圖片格式。jpg 與 jpeg 等價，回應統一回傳 jpeg。

預設值"jpeg"

可用值

"jpeg"
"jpg"
"png"
"webp"

response_format?string

url 連結有效期限為 24 小時；b64_json 回傳 Base64 且不能串流。Base64 總輸出面積上限為 PNG 20,000,000 像素、JPEG／WebP 80,000,000 像素，按張數合計。

預設值"url"

可用值

"url"
"b64_json"

output_compression?integer

JPEG／WebP 壓縮品質，數值越高檔案越大；PNG 忽略此項。

範圍0 <= value <= 100

預設值95

stream?boolean

是否使用 SSE 逐張回傳結果，僅支援 response_format 為 url。

預設值false

aigc_watermark?boolean

是否加入可見 AIGC 浮水印，不影響檔案中繼資料中的隱式標識。

預設值false

image*array<>

參考圖 1–16 張。支援 JPG、JPEG、PNG、WEBP、HEIC、HEIF，單圖及整個請求本文各不超過 64 MiB；邊長 128–8192 像素，長短邊比不超過 4:1。Base64 編碼也計入請求本文大小。每個檔案使用一個 image 欄位，多圖也可使用 image[]；上傳順序對應圖號。

項目數1 <= items <= 16

JSON 圖片引用

JSON 請求使用 images 物件陣列提交參考圖，其餘欄位與檔案上傳方式相同。

欄位	JSON 寫法
`images[].image_url`	必填，支援公開可存取的 URL、Base64 Data URL 或 mm_file://{file_id}。URL 範例可替換為文生圖生成並儲存的圖片位址。

回應主體

`application/json`

type*string

created?integer

事件的 Unix 時間戳記。

model?string

實際使用的模型 ID。

image_index*integer

圖片序號，從 0 開始。

範圍0 <= value

url*string

生成圖片的暫時連結。

size?string

圖片實際寬x高。

output_format?string

實際輸出格式。

可用值

"jpeg"
"png"
"webp"

revised_prompt?string

該張圖片使用的提示詞。

curl -X POST "https://api.agtcloud.cn/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F model="MODEL_ID" \
  -F prompt="把檯燈的綠色燈罩改成米白色，保留木桌、背景、光線和構圖。" \
  -F size="2048x2048" \
  -F n="1" \
  -F response_format="url" \
  -F image="@/path/to/lamp.png"

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "淺色牆面前的木桌上擺放著一盞綠色檯燈，柔和自然光照亮燈罩與桌面。"
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

用戶端逾時建議不低於 600 秒。請求逾時或中斷後，伺服器可能繼續生成；再次傳送會建立新的請求。

MiniMax 編輯圖片 API查看請求參數與回應結構。

授權

請求主體

JSON 圖片引用

回應主體

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

串流回應事件

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`