Langsung ke konten utama
POST

Otorisasi

string
wajib
Semua endpoint memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi halaman manajemen API Key untuk mendapatkan API Key AndaSertakan di header permintaan:

Body

string
default:"mai-image-2.7"
wajib
Nama model pembuatan gambarKedua model memiliki kemampuan dan parameter yang sepenuhnya sama.
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas gambar dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Deskripsi teks atau instruksi edit untuk pembuatan gambar
  • Mendukung bahasa Mandarin dan Inggris; deskripsi yang terperinci direkomendasikan
  • Maksimal 20.000 karakter; jika melebihi akan mengembalikan 400
  • Tidak boleh kosong atau hanya berisi spasi
integer
default:"1"
Jumlah gambar yang akan dibuatNilai: 1
Hanya 1 gambar per permintaan; kirim tugas terpisah untuk beberapa gambar. Nilai 0, negatif, atau lebih dari 1 mengembalikan 400
string
default:"1:1"
Rasio aspek atau dimensi piksel gambar, hanya berlaku untuk text-to-imageMendukung dua format:
  • Rasio aspek: rasio bilangan bulat apa pun dalam rentang 1:4 hingga 4:1, seperti 1:1, 16:9, 9:16, 21:9; bersama resolution menentukan piksel aktual
  • Dimensi piksel: lebarxtinggi (juga mendukung lebar*tinggi dan lebar×tinggi), seperti 2048x1152; dalam mode ini resolution diabaikan
Batas dimensi piksel:
  • Lebar dan tinggi masing-masing ≥ 768
  • Lebar × tinggi ≤ 4.194.304 (2048×2048)
  • Lebar dan tinggi masing-masing dibulatkan ke bawah ke kelipatan 32; misalnya, 1000x1000 menghasilkan 992x992
Contoh: ✅ 2048x2048, 2048x1152, 2560x1536; ❌ 512x512 (sisi kurang dari 768), 2080x2048 (melebihi batas total piksel)
auto tidak didukung; mengirimkannya akan mengembalikan 400
string
default:"1K"
Tingkat resolusi keluaran, hanya berlaku jika size berupa rasio aspekOpsi: 1K / 2K (huruf kecil juga diterima)Pemetaan size × resolution → piksel aktual:
4K tidak didukung; tingkat lain mengembalikan 400. Karena sisi pendek minimal 768, rasio yang lebih memanjang dari 2:1 akan melebihi sekitar 1 juta piksel pada tingkat 1K.
integer
Lebar piksel persis, wajib diberikan bersama height
  • Prioritas tertinggi; jika diberikan, menggantikan size dan resolution
  • Batasannya sama dengan dimensi piksel pada size: lebar dan tinggi ≥ 768, total piksel ≤ 4.194.304
  • Hanya berlaku untuk text-to-image
integer
Tinggi piksel persis, wajib diberikan bersama width, dengan batasan yang sama seperti width
array
Array gambar referensi; jika diberikan, beralih ke mode image-to-image
  • 1 gambar untuk edit gambar tunggal, beberapa gambar untuk komposisi multi-gambar
string
Jenis latar belakangOpsi: auto / opaque, hasilnya sama seperti tidak mengirim parameter ini
Latar belakang transparan (transparent) belum tersedia; mengirim transparent atau nilai lain akan mengembalikan 400
auto_aspect_ratio: true dan web_grounding: true tidak didukung dan akan mengembalikan 400. quality, style, output_format, response_format, dan mask_url tidak didukung dan akan diabaikan. Keluaran selalu PNG.

Contoh Penggunaan

Text-to-image (permintaan minimal) Default 1:1 + 1K, keluaran 1024×1024.
Text-to-image (dengan rasio + 2K)
Text-to-image (piksel persis)
Edit gambar tunggal
Komposisi multi-gambar (campuran URL + base64)

Respons

integer
Kode status respons
array
Array data respons

Mengueri Hasil Tugas

Setelah pengiriman berhasil, task_id dikembalikan. Polling status tugas melalui GET /v1/tasks/{task_id}; lihat API Kueri Tugas untuk detail. Disarankan polling setiap 3–5 detik dengan batas waktu total 3 menit.

Contoh Respons Berhasil

Akses gambar: data.result.images[0].url[0]. Tautan gambar kedaluwarsa setelah expires_at; segera unduh dan simpan gambar tersebut.

Status Tugas