Tạo ảnh

POST/v1/images/generations

Tạo ảnh từ lời nhắc văn bản.

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

application/json

Đị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

Lời nhắc tạo hoặc chỉnh sửa ảnh, 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

disable_prompt_enhanced?boolean

Tắt tăng cường lời nhắc. Khi tắt, chỉ khoảng 4,096 Token đầu có hiệu lực; phải chỉ định size cụ thể hoặc aspect_ratio cố định.

Giá trị mặc địnhfalse

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://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Tạo ảnh chụp một chiếc đèn bàn màu xanh lá trên bàn gỗ, nền là tường màu sáng, ánh sáng tự nhiên dịu nhẹ.",
    "size": "2048x2048",
    "n": 1,
    "response_format": "url"
  }'

{
  "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 tạo ả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

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`