Mage API · Görsel modeli

Grok Image API

Üç kalite seviyesinde Grok Imagine

API anahtarı alGrok Image'i playground'da dene
POST https://api.mage.space/v1/grok_image/generate

Bir bakışta

Grok Image API, Grok Image Quality ve diğer 2 varyantı Mage üzerinden POST https://api.mage.space/v1/grok_image/generate adresinde çalıştırır. Varsayılan ayarlarla bir istek 75 Gems (yaklaşık 0,075 $) tutar, abonelik gerekmez. Grok Image, kayıtlı karakterleri ve referansları istemde @handle ile alır.

Genel bakış

Grok Image API ne yapar?

xAI'ın Grok Imagine görsel modeli, üç kalite seviyesinde. 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, üç kalite seviyesinde; üretim ve referans görsellerden düzenleme için. 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-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"])

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_idAdVarsayılan
grok-imagine-imageGrok Image
grok-imagine-image-qualityGrok Image QualityEvet
grok-imagine-image-2.0Grok Image 2.0

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.

AlanDeğerler
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

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.

AlanRol
imageReferans görsel.
additional_imagesEk referans görseller.

Daha fazla görsel modeli

Mage'deki diğer görsel üretim API'leri

Görsel · 37 Gem'den başlayan fiyatlarla

Guava API

Fotoğraf sanılacak kadar gerçekçi görseller

Görsel · 20 Gem'den başlayan fiyatlarla

HiDream API

Hızlı ve çok yönlü, negatif prompt desteğiyle

Görsel · 20 Gem'den başlayan fiyatlarla

Krea 2 API

Saniyeler içinde muhteşem estetik

Görsel · 135 Gem'den başlayan fiyatlarla

Mango API

Amiral gemisi görsel model ailemiz

Görsel · 68 Gem'den başlayan fiyatlarla

Nano Banana 2 API

Net, okunaklı metin, 4K'ya kadar

Görsel · 15 Gems'ten başlayan fiyatlarla

SDXL Plus API

Yüzleri ve elleri düzeltilmiş SDXL

SSS

Sık sorulan sorular

Grok Image API'si ne kadar tutuyor?

Varsayılan ayarlarla (Grok Image Quality) yapılan bir Grok Image isteği 75 Gems tutar, yani yaklaşık 0,075 $. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; kesin ücret yanıtta bildirilir. Başarısız olan bir üretimin ücreti iade edilir; Mage'in içerik politikasının engellediği üretiminki iade edilmez.

Grok Image API uç noktası nedir?

Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/grok_image/generate. Yanıt, sonucu sorgulamak için bir status_url içerir.

Hangi Grok Image modellerini çağırabilirim?

grok-imagine-image (Grok Image), grok-imagine-image-quality (Grok Image Quality), grok-imagine-image-2.0 (Grok Image 2.0). Varsayılan model Grok Image Quality'dir.

Grok Image referans görsellerini veya karakterleri destekliyor mu?

Grok Image image ve additional_images kabul eder. Grok Image, kayıtlı karakterleri ve referansları istemde @handle ile alır.

Grok Image'i Claude veya ChatGPT'den kullanabilir miyim?

Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Grok Image'i adıyla iste. Asistanın seçeneklerini get_model ile okur ve üretmeden önce fiyatı söyler.

Grok Image sonuçları ne kadar süre saklanır?

Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

API anahtarı alGrok Image'i playground'da dene

İlgili