MiniMax H3 Image API
Referensi API lengkap untuk model MiniMax H3 Image yang menghasilkan gambar dari teks dan mengedit gambar.
Varian Model
API ini mendukung dua varian model:
Perbandingan Singkat
Rasio Aspek yang Didukung
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
Berikan rasio sebagai nilai numerik width dan height yang terpisah, bukan dimensi piksel. Jika kedua nilai tidak diberikan, rasio default adalah 1:1; jika tidak, berikan kedua nilai menggunakan salah satu pasangan bilangan bulat yang didukung.
MiniMax H3 Image (Teks ke Gambar)
Titik Akhir
POST /api/v1/image/task
Autentikasi
Authorization: Bearer YOUR_API_KEY
Parameter Permintaan
Wajib
Opsional
Catatan: Rasio lebar:tinggi harus merupakan salah satu dari 15 rasio yang didukung di atas.
Contoh Permintaan
javascript
MiniMax H3 Image Edit (Pengeditan Gambar)
Titik Akhir
POST /api/v1/image/task
Parameter Permintaan
Wajib
Opsional
Catatan: Rasio lebar:tinggi harus merupakan salah satu dari 15 rasio yang didukung di atas.
Contoh Permintaan
javascript
Contoh Pengeditan Satu Gambar
javascript
Contoh Komposisi Beberapa Gambar
javascript
Format Respons
Respons Awal
json
Respons Polling
Lakukan polling ke GET /api/v1/image/{task_id} untuk memeriksa status. Respons polling yang berhasil menyediakan URL gambar yang dihasilkan pada data.task_result.images[].url.
Nilai Status
submitted: Tugas diterimaprocessing: Pembuatan gambar sedang berlangsungsucceed: Pembuatan gambar selesaifailed: Pembuatan gambar gagal
Praktik Terbaik
- Prompt Terperinci: Jelaskan subjek, pencahayaan, dan komposisi, dengan panjang prompt maksimal 5000 karakter
- Pemilihan Resolusi: Kirimkan
1k,2k, atau4ksecara eksplisit pada setiap permintaan - Rasio Aspek: Gunakan nilai rasio berpasangan untuk
widthdanheight, atau jangan berikan keduanya untuk menggunakan1:1 - Kualitas Pengeditan Gambar: Sediakan 1-16 gambar referensi yang memenuhi persyaratan format dan dimensi yang didukung