Mage API · Model gambar
API Grok Image
Grok Imagine, dalam dua tingkatan
POST https://api.mage.space/v1/grok_image/generateSekilas info
Grok Image API menjalankan Grok Image 2.0 dan 1 varian lainnya lewat Mage di POST https://api.mage.space/v1/grok_image/generate. Satu permintaan dengan pengaturan default membutuhkan 90 Gems (sekitar $0,09), tanpa langganan. Grok Image mendukung karakter tersimpan dan referensi lewat @handle di prompt.
- GambarOutput
- 2Varian
- 90Gems per gambar, default
- $0.09Perkiraan, dalam USD
Ringkasan
Fungsi API Grok Image
Model gambar Grok Imagine dari xAI dalam dua tingkatan. Membuat atau mengedit gambar dari hingga 3 gambar referensi sambil menjaga detail aslinya tetap utuh. Filter keamanan xAI berlaku.
Model gambar Grok Imagine dari xAI dalam dua tingkatan, untuk membuat dan mengedit gambar dari gambar referensi: Grok Image 2.0 (`grok-imagine-image-2.0`) sebagai default, dan Grok Image (`grok-imagine-image`) untuk draf yang hemat. xAI telah menghentikan Grok Image Quality (`grok-imagine-image-quality`) pada 2 November 2026, dan permintaan yang menyebutkannya akan ditolak. Filter keamanan xAI berlaku.
Menerima image dan additional_images sebagai input.
Mulai cepat
Panggil API Grok Image
Setel MAGE_API_KEY, kirim ke /grok_image/generate, lalu lakukan polling ke status_url sampai permintaan selesai.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('grok_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'grok-imagine-image-2.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0",
})
print(request["result"]["url"])Model
Nilai model_id Grok Image
Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.
| model_id | Nama | Default |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Ya |
Opsi
Parameter Grok Image
Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.
| Kolom | Nilai |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20 |
| resolution | 1k, 2k |
Input
Input media yang didukung Grok Image
Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.
| Kolom | Peran |
|---|---|
| image | Gambar referensi. |
| additional_images | Gambar referensi tambahan. |
Model gambar lainnya
API pembuat gambar lainnya di Mage
Guava API
Fotorealisme yang tampak seperti foto asli
HiDream API
Cepat dan serbaguna, dengan negative prompt
Krea 2 API
Estetika memukau dalam hitungan detik
Mango API
Keluarga model gambar andalan kami
MiniMax H3 Image API
Gambar native 16 megapiksel, open weights
MOSS-Image API
Prompt panjang dan teks dwibahasa, open weights
FAQ
Pertanyaan yang sering diajukan
Berapa biaya API Grok Image?
Apa endpoint API Grok Image?
Model Grok Image mana saja yang bisa kupanggil?
Apakah Grok Image mendukung gambar referensi atau karakter?
Bisakah aku memakai Grok Image dari Claude atau ChatGPT?
Berapa lama hasil Grok Image disimpan?
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.