Sekilas info
API Grok Image menjalankan Grok Image Quality dan 2 varian lainnya lewat Mage di POST https://api.mage.space/v1/grok_image/generate. Satu permintaan dengan pengaturan default berharga 75 Gems (sekitar $0,075), tanpa langganan. Grok Image bisa memakai karakter dan referensi yang tersimpan lewat @handle di prompt.
Gambar
Output
3
Varian
75
Gems per gambar, default
$0.075
Perkiraan, dalam USD
Ringkasan
Fungsi API Grok Image
Model gambar Grok Imagine dari xAI dalam tiga tingkat kualitas. Membuat atau mengedit gambar dari hingga 3 gambar referensi dengan tetap menjaga detail sumbernya. Filter keamanan xAI berlaku.
Model gambar Grok Imagine dari xAI dalam tiga tingkat kualitas, untuk membuat dan mengedit gambar dari gambar referensi. 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-quality"
}' | 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-quality',
});
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-quality",
})
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-quality | Grok Image Quality | Ya |
| grok-imagine-image-2.0 | Grok Image 2.0 |
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
Gambar · mulai dari 37 Gems
Guava API
Fotorealisme yang tampak seperti foto asli
Gambar · mulai 20 Gems
HiDream API
Cepat dan serbaguna, dengan negative prompt
Gambar · mulai 20 Gems
Krea 2 API
Estetika memukau dalam hitungan detik
Gambar · mulai dari 135 Gems
Mango API
Keluarga model gambar andalan kami
Gambar · mulai dari 68 Gems
Nano Banana 2 API
Teks tajam dan mudah dibaca, hingga 4K
Gambar · mulai dari 15 Gems
API SDXL Plus
SDXL dengan wajah dan tangan yang sudah diperbaiki
FAQ
Pertanyaan yang sering diajukan
Berapa biaya API Grok Image?
Satu permintaan Grok Image dengan pengaturan default (Grok Image Quality) berharga 75 Gems, sekitar $0,075. Resolusi, durasi, dan varian lain akan mengubah harganya; respons menampilkan biaya pastinya. Generasi yang gagal akan dikembalikan Gems-nya; generasi yang diblokir oleh kebijakan konten Mage tidak dikembalikan.
Apa endpoint API Grok Image?
POST https://api.mage.space/v1/grok_image/generate dengan header Authorization: Bearer yang berisi kunci API Mage milikmu. Respons berisi status_url untuk di-polling guna mendapatkan hasilnya.
Model Grok Image mana saja yang bisa kupanggil?
grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). Defaultnya adalah Grok Image Quality.
Apakah Grok Image mendukung gambar referensi atau karakter?
Grok Image menerima image, additional_images. Grok Image juga bisa memakai karakter dan referensi yang tersimpan lewat @handle di prompt.
Bisakah aku memakai Grok Image dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Grok Image dengan menyebut namanya. Asistenmu membaca opsinya lewat get_model dan menyebutkan harga sebelum membuat gambar.
Berapa lama hasil Grok Image disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.