Langsung ke konten

Mage API · Model gambar

API Grok Image

Grok Imagine, dalam dua tingkatan

POST https://api.mage.space/v1/grok_image/generate

Sekilas 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_idNamaDefault
grok-imagine-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0Ya

Opsi

Parameter Grok Image

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

KolomNilai
aspect_ratio1: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
resolution1k, 2k

Input

Input media yang didukung Grok Image

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

KolomPeran
imageGambar referensi.
additional_imagesGambar 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 42 Gems

    Mango API

    Keluarga model gambar andalan kami

  • Gambar · mulai dari 15 Gems

    MiniMax H3 Image API

    Gambar native 16 megapiksel, open weights

  • Gambar · mulai dari 25 Gems

    MOSS-Image API

    Prompt panjang dan teks dwibahasa, open weights

FAQ

Pertanyaan yang sering diajukan

Berapa biaya API Grok Image?
Satu permintaan Grok Image dengan pengaturan default (Grok Image 2.0) membutuhkan 90 Gems, sekitar $0,09. Resolusi, durasi, dan varian lain akan mengubah harganya; biaya pastinya tercantum di respons. Generasi yang gagal akan dikembalikan Gems-nya, tetapi yang diblokir oleh kebijakan konten Mage tidak.
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-2.0 (Grok Image 2.0). Defaultnya adalah Grok Image 2.0.
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.

CharactersKomunitas