MiniMax H3 Image API
Tài liệu tham khảo API đầy đủ cho các mô hình MiniMax H3 Image tạo ảnh từ văn bản và chỉnh sửa ảnh.
Các Biến Thể Mô Hình
API này hỗ trợ hai biến thể mô hình:
So Sánh Nhanh
Tỷ Lệ Khung Hình Được Hỗ Trợ
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Cung cấp tỷ lệ dưới dạng hai giá trị số riêng biệt width và height, không phải kích thước pixel. Nếu bỏ qua cả hai giá trị, tỷ lệ mặc định là 1:1; nếu không, hãy cung cấp cả hai giá trị bằng một trong các cặp số nguyên được hỗ trợ.
MiniMax H3 Image (Tạo Ảnh Từ Văn Bản)
Điểm Cuối
POST /api/v1/image/task
Xác Thực
Authorization: Bearer YOUR_API_KEY
Tham Số Yêu Cầu
Bắt Buộc
Tùy Chọn
Lưu ý: Tỷ lệ chiều rộng:chiều cao phải là một trong 15 tỷ lệ được hỗ trợ ở trên.
Ví Dụ Yêu Cầu
javascript
MiniMax H3 Image Edit (Chỉnh Sửa Ảnh)
Điểm Cuối
POST /api/v1/image/task
Tham Số Yêu Cầu
Bắt Buộc
Tùy Chọn
Lưu ý: Tỷ lệ chiều rộng:chiều cao phải là một trong 15 tỷ lệ được hỗ trợ ở trên.
Ví Dụ Yêu Cầu
javascript
Ví Dụ Chỉnh Sửa Một Ảnh
javascript
Ví Dụ Kết Hợp Nhiều Ảnh
javascript
Định Dạng Phản Hồi
Phản Hồi Ban Đầu
json
Phản Hồi Thăm Dò
Gửi yêu cầu thăm dò GET /api/v1/image/{task_id} để kiểm tra trạng thái. Phản hồi thăm dò thành công cung cấp URL ảnh đã tạo tại data.task_result.images[].url.
Các Giá Trị Trạng Thái
submitted: Tác vụ đã được chấp nhậnprocessing: Đang tạo ảnhsucceed: Đã hoàn tất tạo ảnhfailed: Tạo ảnh thất bại
Các Phương Pháp Tốt Nhất
- Câu lệnh chi tiết: Mô tả chủ thể, ánh sáng và bố cục, giữ câu lệnh trong giới hạn 5000 ký tự
- Chọn độ phân giải: Truyền rõ ràng
1k,2khoặc4ktrong mỗi yêu cầu - Tỷ lệ khung hình: Sử dụng cặp giá trị tỷ lệ cho
widthvàheight, hoặc bỏ qua cả hai để dùng1:1 - Chất lượng chỉnh sửa ảnh: Cung cấp 1-16 ảnh tham chiếu đáp ứng yêu cầu về định dạng và kích thước được hỗ trợ