Skip to main content
POST
Endpoint ini juga menerima alias grok-imagine-1.5-ext, setara dengan grok-imagine-1.5-apimart dan dapat saling diganti.

Authorizations

string
wajib
Semua API memerlukan autentikasi Bearer TokenDapatkan API Key:Kunjungi halaman manajemen API KeyTambahkan di header permintaan:

Body

string
default:"grok-imagine-1.5-apimart"
wajib
Nama model generasi gambarModel yang didukung:
  • grok-imagine-1.5-apimart - generasi dan pengeditan gambar Grok (alias grok-imagine-1.5-ext)
Contoh:"grok-imagine-1.5-ext"
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 untuk generasi atau pengeditan gambar
string[]
Daftar URL gambar referensi. Hilangkan untuk text-to-image; sertakan untuk pengeditan.
  • Model ini mendukung 1–5 gambar referensi
  • Hanya menerima URL absolut http:// atau https:// yang dapat diakses publik
  • Unggah gambar lokal terlebih dahulu dengan POST /v1/uploads/images, lalu gunakan url yang dikembalikan
string
default:"1:1"
Ukuran gambar keluaranFormat yang didukung:
  • 1:1 - Persegi (default)
  • 16:9 - Lanskap widescreen
  • 9:16 - Potret
  • 3:2 - Lanskap
  • 2:3 - Potret
integer
default:1
Jumlah gambar yang dihasilkanRentang: 1-10 (minimum 1, maksimum 10)⚠️ Catatan: harus angka polos (mis. 1), jangan diberi tanda kutip, atau akan error

Response

integer
Kode status respons
array
Array data respons

Kasus penggunaan

Kasus 1: Text-to-Image

Kasus 2: Text-to-Image (ukuran & jumlah)

Kasus 3: Pengeditan gambar (latar)

Kasus 4: Pengeditan gambar (gaya)

Model resmi

grok-imagine-image dan grok-imagine-image-quality menggunakan alur tugas asinkron yang sama seperti model gambar lainnya. Setelah mengirim permintaan, gunakan ID tugas yang dikembalikan dan periksa status tugas hingga selesai atau gagal.
Jangan kirim quality. Tanpa image_urls, model membuat gambar dari teks; satu gambar mengaktifkan pengeditan, beberapa gambar menjadi multi-referensi.

Parameter permintaan

Nilai aspect_ratio: 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto.

Respons pembuatan tugas

202
Gunakan data.id atau data.poll_url hingga status menjadi completed atau failed.