Chỉnh sửa ảnh

POST/v1/images/edits

Tải ảnh tham chiếu lên và chỉnh sửa theo lời nhắc.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng API Key của nền tảng theo định dạng Authorization: Bearer your-api-key.

Vị trí truyền: header

Nội dung yêu cầu

multipart/form-data

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình của nền tảng.

prompt*string

Chỉ dẫn chỉnh sửa ảnh, luôn bật tăng cường lời nhắc. Tính theo ký tự Unicode, không gồm khoảng trắng đầu cuối; không được chỉ chứa khoảng trắng.

Độ dài1 <= length <= 32000

n?integer

Số ảnh cần tạo.

Phạm vi1 <= value <= 10

Giá trị mặc định1

size?string

auto hoặc WIDTHxHEIGHT, mặc định auto. Diện tích tùy chỉnh 655,360–20,000,000 pixel, tỷ lệ 1:3–3:1; bỏ aspect_ratio và area khi chỉ định kích thước.

Giá trị mặc định"auto"

aspect_ratio?string

Mặc định auto, do lời nhắc được tăng cường quyết định và kết hợp ảnh tham chiếu khi chỉnh sửa. Có thể dùng X:Y, X và Y là số nguyên 1–300, tỷ lệ 1:3–3:1. Chỉ dùng khi bỏ size hoặc size là auto.

area?string

Mức diện tích, mặc định 4K. Chỉ dùng khi bỏ size hoặc size là auto; kích thước thực tế nằm trong data[].size.

Giá trị được phép

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

output_format?string

Định dạng ảnh. jpg và jpeg tương đương, phản hồi thống nhất dùng jpeg.

Giá trị mặc định"jpeg"

Giá trị được phép

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

response_format?string

Liên kết url có hiệu lực 24 giờ; b64_json trả Base64 và không hỗ trợ luồng. Tổng diện tích ảnh Base64 tối đa là 20,000,000 pixel với PNG và 80,000,000 pixel với JPEG/WebP, cộng tất cả ảnh.

Giá trị mặc định"url"

Giá trị được phép

"url"
"b64_json"

output_compression?integer

Chất lượng nén JPEG/WebP; giá trị cao hơn tạo tệp lớn hơn. Bỏ qua với PNG.

Phạm vi0 <= value <= 100

Giá trị mặc định95

stream?boolean

Trả từng ảnh qua SSE; chỉ hỗ trợ response_format là url.

Giá trị mặc địnhfalse

aigc_watermark?boolean

Thêm hình mờ AIGC hiển thị; không ảnh hưởng dấu nhận diện ẩn trong siêu dữ liệu tệp.

Giá trị mặc địnhfalse

image*array<>

1–16 ảnh tham chiếu. Hỗ trợ JPG, JPEG, PNG, WEBP, HEIC, HEIF. Mỗi ảnh và toàn bộ nội dung yêu cầu đều không quá 64 MiB; cạnh dài 128–8192 pixel, tỷ lệ cạnh dài/ngắn không quá 4:1. Dữ liệu mã hóa Base64 cũng được tính vào kích thước yêu cầu. Mỗi tệp dùng một trường image, nhiều tệp cũng có thể dùng image[]; thứ tự tải lên là thứ tự ảnh.

Số phần tử1 <= items <= 16

Tham chiếu ảnh JSON

Yêu cầu JSON gửi ảnh tham chiếu bằng mảng đối tượng images; các trường khác giống cách tải tệp lên.

Trường Cách viết JSON

Trường	Cách viết JSON
`images[].image_url`	Bắt buộc. Hỗ trợ URL công khai, Base64 Data URL hoặc mm_file://{file_id}. Thay URL mẫu bằng địa chỉ ảnh đã tạo và lưu. Bắt buộc. Hỗ trợ URL công khai, Base64 Data URL hoặc mm_file://{file_id}. Thay URL mẫu bằng địa chỉ ảnh đã tạo và lưu.

images[].image_url

Bắt buộc. Hỗ trợ URL công khai, Base64 Data URL hoặc mm_file://{file_id}. Thay URL mẫu bằng địa chỉ ảnh đã tạo và lưu.

Nội dung phản hồi

`application/json`

type*string

created?integer

Dấu thời gian Unix của sự kiện.

model?string

ID mô hình thực tế được dùng.

image_index*integer

Chỉ số ảnh, bắt đầu từ 0.

Phạm vi0 <= value

url*string

Liên kết tạm thời của ảnh được tạo.

size?string

WIDTHxHEIGHT thực tế của ảnh.

output_format?string

Định dạng đầu ra thực tế.

Giá trị được phép

"jpeg"
"png"
"webp"

revised_prompt?string

Lời nhắc dùng cho ảnh này.

curl -X POST "https://api.agtcloud.ai/v1/images/edits" \
  -H "Authorization: Bearer your-api-key" \
  -F model="MODEL_ID" \
  -F prompt="Đổi chụp đèn màu xanh lá thành trắng ngà, giữ nguyên bàn gỗ, nền, ánh sáng và bố cục." \
  -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": "Một chiếc đèn bàn màu xanh lá đặt trên bàn gỗ trước tường màu sáng, ánh sáng tự nhiên dịu chiếu lên chụp đèn và mặt bàn."
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

Nên đặt thời gian chờ phía máy khách ít nhất 600 giây. Sau khi hết thời gian chờ hoặc ngắt kết nối, máy chủ có thể tiếp tục tạo ảnh; gửi lại sẽ tạo yêu cầu mới.

API chỉnh sửa ảnh MiniMaxXem tham số yêu cầu và cấu trúc phản hồi.

Xác thực

Nội dung yêu cầu

Tham chiếu ảnh JSON

Nội dung phản hồi

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

Sự kiện phản hồi dạng luồng

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`