Apa Itu MiniMax H3-Image?

MiniMax H3-Image adalah model gambar open-weight dari MiniMax, dirilis pada 10 November 2026, yang mampu menghasilkan dan mengedit gambar dengan resolusi sekitar 16 megapiksel (4096 x 4096) tanpa upscaler. Menurut MiniMax, satu gambar 4K hanya butuh sekitar 10 detik. Anda bisa memanggilnya melalui MiniMax API, menggunakannya di Hailuo AI dan MiniMax Code, atau mengunduh bobotnya dari Hugging Face.

Panduan ini menjelaskan apa itu MiniMax H3-Image, apa saja klaim MiniMax, apa arti "open-weight" menurut lisensinya, berapa biayanya selama diskon pekan peluncuran, dan cara menguji API-nya dari coding agent Anda.

Apa itu MiniMax H3-Image?

MiniMax H3-Image adalah model text-to-image dan pengeditan gambar dalam keluarga MiniMax H3. Satu checkpoint menangani kedua tugas: ia membuat gambar dari sebuah prompt dan mengedit hingga 16 gambar referensi. Ia menghasilkan sekitar 16 megapiksel dengan rasio aspek apa pun, dari 4096 x 4096 (1:1) hingga 6272 x 2688 (21:9), dan bobotnya dipublikasikan di bawah lisensi komunitas.

Dalam postingan peluncuran di X, MiniMax menawarkan pitch singkat: "pembuatan gambar 4K dalam 10 detik," 16 juta piksel, realisme, kepatuhan prompt yang presisi dan pengeditan, hingga 16 gambar referensi, serta bobot terbuka.

H3-Image terpisah dari model coding MiniMax yang dibahas dalam penjelasan MiniMax M3, dan memiliki endpoint API tersendiri.

Klaim MiniMax tentang H3-Image

Berikut yang dipublikasikan MiniMax di model card Hugging Face dan dalam pengumumannya. Anggap pernyataan soal kecepatan dan kualitas sebagai klaim MiniMax; tidak ada pihak luar perusahaan yang mempublikasikan pengukuran independen saat artikel ini ditulis.

Klaim kecepatan bertumpu pada 6 langkah hasil distilasi dan tanpa classifier-free guidance, yang biasanya menggandakan pekerjaan per langkah. MiniMax tidak menyebut perangkat keras yang dipakai untuk mencapai angka 10 detik tersebut, jadi jangan anggap itu sebagai janji untuk GPU Anda sendiri.

Model card tidak menyertakan tabel benchmark untuk mendukung klaim kepatuhan instruksi. Artikel kembarnya, MiniMax H3-Image vs Nano Banana 2.1, membandingkan keduanya secara berdampingan.

Isi di balik model

Model card menjelaskan arsitektur dengan sangat spesifik:

• Diffusion transformer: 33,1 miliar parameter, transformer single-stream dense dengan 50 layer, disimpan dalam BF16 (68,65 GB).
• Text encoder: text encoder MiniMax-H3, tanpa perubahan, dimuat dari repositori MiniMax-H3 terpisah (66,7 GB).
• Image VAE: downsampling spasial 16x dan 24 channel laten (2,34 GB).
• Prompt expander opsional: MiniMax-H3-Image-PE (17,9 GB, NVFP4), yang mengubah prompt singkat menjadi deskripsi bahasa Inggris terperinci yang diharapkan oleh model.

Jika dijumlahkan, satu setup lokal lengkap mengunduh sekitar 137 GB sebelum prompt expander opsional.

Apa arti "open-weight" untuk MiniMax H3-Image

MiniMax H3-Image bersifat open-weight, bukan open-source dalam arti OSI. Anda bisa mengunduh dan menjalankan bobotnya, tetapi MiniMax-H3-Image Community License menetapkan batasan nyata. Baca lisensinya sebelum membangun di atasnya. Poin-poin yang berdampak pada sebagian besar tim:

1. Wilayah. Lisensi memberikan hak di seluruh dunia kecuali di "Excluded Territories": Uni Eropa, Inggris, Republik Korea, dan Amerika Serikat. Tim di wilayah tersebut perlu menghubungi MiniMax untuk lisensi terpisah.
2. Pendapatan dan hosting. Anda memerlukan otorisasi tertulis sebelumnya dari MiniMax jika Anda beserta afiliasi Anda memperoleh pendapatan tahunan lebih dari $1 juta, atau jika Anda menawarkan model sebagai layanan hosting kepada pihak ketiga. Permintaan dilakukan melalui konsol lisensi MiniMax.
3. Atribusi. Produk komersial harus menampilkan "MiniMax-H3-Image" secara menonjol di antarmuka pengguna.
4. Larangan melatih model lain. Anda tidak boleh menggunakan model atau keluarannya untuk meningkatkan model AI lain.
5. Keterbukaan. Kebijakan penggunaan yang dapat diterima melarang publikasi konten hasil generasi secara publik tanpa menyebutkan dengan jelas bahwa konten tersebut dibuat oleh mesin.

MiniMax tidak mengklaim hak atas gambar yang Anda hasilkan. Jika Anda hanya memanggil API yang dihosting, baca juga ketentuan platform MiniMax untuk penggunaan tersebut.

Di mana Anda bisa menggunakan MiniMax H3-Image

Ada empat jalur tersedia:

• MiniMax API. Text-to-image di POST https://api.minimax.io/v1/images/generations dan pengeditan di /v1/images/edits, keduanya dengan ID model MiniMax-H3-Image atau versi lebih cepat MiniMax-H3-Image-Highspeed. Penjelasan lengkapnya ada di panduan MiniMax H3-Image API kami.
• Hailuo AI. Aplikasi web MiniMax, tanpa perlu kode.
• MiniMax Code. Aplikasi desktop MiniMax untuk macOS dan Windows, yang disebut dalam postingan peluncuran sebagai salah satu tempat menggunakan H3-Image.
• Self-hosting. MiniMax merekomendasikan SGLang, vLLM-Omni, diffusers, atau ComfyUI, dan mencantumkan NVIDIA H200, RTX PRO 6000 Blackwell, serta AMD Instinct MI350X di antara akselerator yang didukung. Model card tidak menyebutkan angka VRAM minimum.

Jika Anda mencari jalur tanpa biaya, artikel MiniMax H3-Image for free membahasnya.

Cara kerja MiniMax H3-Image API

API ini mengikuti format images bergaya OpenAI, sehingga request-nya singkat:

curl https://api.minimax.io/v1/images/generations \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3-Image",
    "prompt": "An orange cat on a sunny windowsill, film texture",
    "aspect_ratio": "16:9",
    "area": "4K",
    "response_format": "url"
  }'

Parameter-parameter yang perlu Anda ketahui, dari referensi API:

• size menerima WIDTHxHEIGHT (655.360 hingga 20.000.000 piksel, rasio aspek antara 1:3 dan 3:1) atau auto. Dengan auto, Anda menentukan aspect_ratio dan area (1K, 2K, atau 4K, default 4K) sebagai gantinya. Mencampur kedua bentuk akan menghasilkan 400.
• n meminta 1 hingga 10 gambar per request.
• output_format defaultnya jpeg, atau bisa png atau webp.
• response_format berupa url (unduh sendiri, karena URL tidak dijamin tersedia selamanya) atau b64_json.
• stream: true mengirim setiap gambar melalui server-sent events saat selesai dibuat.
• Peningkatan prompt aktif secara default. Setiap hasil menyertakan revised_prompt yang menunjukkan prompt yang benar-benar digunakan model. Setel disable_prompt_enhanced: true untuk mengirim prompt Anda apa adanya.

Satu perilaku sering membuat orang keliru: jika setidaknya satu gambar berhasil, panggilan mengembalikan HTTP 200 meskipun gambar lain gagal pada pemeriksaan keamanan konten. Periksa data[].error pada setiap item. Hanya gambar yang berhasil yang ditagih.

Panduan ini juga mencantumkan hal-hal yang tidak didukung: gambar pratinjau, pengeditan bertopeng, dan latar belakang transparan.

Untuk pengeditan, Anda mengirimkan 1 hingga 16 gambar referensi sebagai URL publik, ID file yang diunggah, atau data URI, maksimal total 64 MiB per request. Prompt Anda merujuknya sebagai <Picture 1>, <Picture 2>, dan seterusnya, sesuai urutan unggah.

Harga MiniMax H3-Image dan diskon pekan peluncuran

MiniMax menagih H3-Image per juta token, dibagi menjadi input teks, input gambar, dan output gambar. Dari halaman harga MiniMax, dicek pada 11 November 2026:

Contoh biaya dari MiniMax sendiri per hasil text-to-image pada model standar adalah $0,02179 untuk 1K, $0,02333 untuk 2K, dan $0,06879 untuk 4K. Contoh Highspeed 4K adalah $0,13001.

Diskon peluncuran adalah potongan 50% dari total biaya request pada kedua model ketika gambar yang dihasilkan memiliki minimal 16.600.000 piksel. Diskon berlaku hingga 17 November 2026 pukul 16.00 UTC. Selama periode tersebut, MiniMax mencantumkan hasil text-to-image 4K standar seharga $0,03439 dan versi Highspeed seharga $0,06501. Gambar yang lebih kecil tidak memenuhi syarat, sehingga render 2K tetap berharga sama seperti sebelumnya.

Uji MiniMax H3-Image API dengan Apidog CLI

Sebelum mengintegrasikan H3-Image ke sebuah aplikasi, pastikan dulu format request, autentikasi, dan penanganan error Anda bekerja dengan baik, termasuk kasus "200 dengan item yang gagal". Biarkan coding agent Anda membangun dan menjalankan pemeriksaan tersebut dengan Apidog CLI alih-alih mencoba request secara manual.

Pasang CLI sekali saja:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

Skill tersebut mengajarkan perintah-perintah CLI kepada agent Anda (Claude Code, Codex, Cursor, atau lainnya). Lalu berikan satu prompt:

In Apidog project <projectId>, add the MiniMax H3-Image endpoint
POST /v1/images/generations from https://platform.minimax.io/docs/api-reference/image-generation-h3-generations
with Bearer auth from {{MINIMAX_API_KEY}}. Create an environment with base URL
https://api.minimax.io. Write a test case that sends model MiniMax-H3-Image,
area 1K, n 1, and asserts status 200, data[0].url exists, data[0].error is absent
and usage.generated_images equals 1. Run it and summarize the result.

Agent mengubahnya menjadi serangkaian perintah apidog yang singkat. Setiap flag di bawah ini berasal dari apidog <command> --help pada Apidog CLI 2.2.12:

apidog environment create --project <projectId> --base-url https://api.minimax.io
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file ./h3-endpoint.json
apidog endpoint create --project <projectId> --file ./h3-endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema validate test-case-create --file ./h3-case.json
apidog test-case create --project <projectId> --file ./h3-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
  --env-var "MINIMAX_API_KEY=$MINIMAX_API_KEY" -r cli,json

cli-schema get memberi agent bentuk JSON yang persis, dan cli-schema validate memeriksa setiap file sebelum ada yang ditulis. test-case category memberinya ID kategori yang valid agar test case muncul di aplikasi. Eksekusi mencetak ringkasan lulus atau gagal di terminal Anda dan menulis laporan JSON yang dibaca agent untuk memutuskan apa yang perlu diperbaiki. Tambahkan --upload-report untuk melihat eksekusi yang sama di Apidog.

Menggunakan area: 1K menjaga setiap panggilan uji tetap pada harga contoh terendah yang tercantum oleh MiniMax. Untuk informasi lebih lanjut tentang pola ini, lihat alur kerja agent Apidog CLI dan Apidog CLI di Claude Code. Paket Free Apidog mencakup hingga 4 pengguna.

Perlukah Anda mencoba MiniMax H3-Image?

Cobalah jika Anda membutuhkan gambar besar dan detail serta menginginkan opsi open-weight, atau jika pengeditan multi-referensi (foto produk, tata ruang, character sheet) adalah use case Anda. Diskon peluncuran membuat pengujian 4K menjadi murah hingga 17 November.

Pikirkan dua kali sebelum melakukan self-hosting: sekitar 137 GB bobot, GPU pusat data, dan lisensi yang mengecualikan UE, Inggris, Republik Korea, dan AS. Bagi sebagian besar tim, API adalah jalur yang paling praktis. Jika Anda sedang membandingkan API gambar, panduan kami tentang GPT Image 2.6 API, Nano Banana 2.1 API, dan Qwen-Image 2.1 membahas alternatif-alifernatifnya.

FAQ

Apakah MiniMax H3-Image gratis? Bobotnya bebas royalti untuk diunduh dan dijalankan di dalam wilayah yang diizinkan lisensi, dengan mematuhi batasan pendapatan dan hostingnya. API-nya berbayar per token. Lihat panduan akses gratis kami untuk jalur tanpa biaya.

Apakah MiniMax H3-Image open-source? MiniMax menyebutnya open-source di Hugging Face, tetapi model ini dirilis di bawah lisensi komunitas khusus dengan pembatasan wilayah, pendapatan, atribusi, dan larangan pelatihan model lain. "Open-weight" adalah istilah yang lebih tepat.

Seberapa cepat MiniMax H3-Image? MiniMax menyebut satu gambar 4K butuh sekitar 10 detik. Itu angka dari perusahaan; mereka tidak menyebut perangkat kerasnya, dan tidak ada benchmark independen saat artikel ini ditulis.

Apa perbedaan antara MiniMax-H3-Image dan MiniMax-H3-Image-Highspeed? Keduanya menerima parameter dan batasan yang sama. Highspeed adalah tingkatan yang lebih cepat dan lebih mahal: $7,60 per juta token output gambar dibandingkan $3,80.

Berapa banyak gambar referensi yang bisa digunakan MiniMax H3-Image? Hingga 16 per request pengeditan, masing-masing 128 hingga 8.192 piksel per sisi, dengan keseluruhan body request dibatasi maksimal 64 MiB.

Kapan diskon peluncuran MiniMax H3-Image berakhir? 17 November 2026, pukul 16.00 UTC. Diskon hanya berlaku untuk gambar berukuran minimal 16.600.000 piksel.