Mage API · Görsel modeli
Grok Image API
Grok Imagine, iki seviyede
POST https://api.mage.space/v1/grok_image/generateBir bakışta
Grok Image API, Grok Image 2.0 ve 1 diğer varyantı Mage üzerinden POST https://api.mage.space/v1/grok_image/generate adresinde çalıştırır. Varsayılan ayarlarla yapılan bir istek 90 Gem (yaklaşık $0,09) tutar, abonelik gerekmez. Grok Image, kayıtlı karakterleri ve prompt içinde @handle ile verilen referansları kabul eder.
- GörselÇıktı
- 2Varyantlar
- 90Görsel başına Gems, varsayılan
- $0.09Yaklaşık, USD
Genel bakış
Grok Image API ne yapar?
xAI'ın Grok Imagine görsel modeli, iki seviyede. En fazla 3 referans görselden üretim yapar veya düzenler, kaynağın ayrıntılarını korur. xAI'ın güvenlik filtresi geçerlidir.
xAI'ın Grok Imagine görsel modelleri, iki seviyede; referans görsellerden üretim ve düzenleme için: varsayılan olan Grok Image 2.0 (`grok-imagine-image-2.0`) ve ucuz taslaklar için Grok Image (`grok-imagine-image`). xAI, Grok Image Quality (`grok-imagine-image-quality`) modelini 2 Kasım 2026'da kullanımdan kaldırdı ve bu modeli belirten istekler reddedilir. xAI'ın güvenlik filtresi geçerlidir.
Girdi olarak image, additional_images kabul eder.
Hızlı başlangıç
Grok Image API'sini çağırma
MAGE_API_KEY'i ayarla, isteği /grok_image/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.
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"])Modeller
Grok Image model_id değerleri
Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.
| model_id | Ad | Varsayılan |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Evet |
Seçenekler
Grok Image parametreleri
Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.
| Alan | Değerler |
|---|---|
| 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 |
Girdiler
Grok Image'in kabul ettiği medya girdileri
Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.
| Alan | Rol |
|---|---|
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
Daha fazla görsel modeli
Mage'deki diğer görsel üretim API'leri
Guava API
Fotoğraf sanılacak kadar gerçekçi görseller
HiDream API
Hızlı ve çok yönlü, negatif prompt desteğiyle
Krea 2 API
Saniyeler içinde muhteşem estetik
Mango API
Amiral gemisi görsel model ailemiz
MiniMax H3 Image API
Yerel 16 megapiksel görseller, açık ağırlıklar
MOSS-Image API
Uzun prompt'lar ve iki dilli metin, açık ağırlıklar
SSS
Sık sorulan sorular
Grok Image API'si ne kadar tutuyor?
Grok Image API uç noktası nedir?
Hangi Grok Image modellerini çağırabilirim?
Grok Image referans görsellerini veya karakterleri destekliyor mu?
Grok Image'i Claude veya ChatGPT'den kullanabilir miyim?
Grok Image sonuçları ne kadar süre saklanır?
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.