Mage API · Bildmodell
Grok Image API
Grok Imagine in zwei Stufen
POST https://api.mage.space/v1/grok_image/generateAuf einen Blick
Die Grok Image API führt Grok Image 2.0 und eine weitere Variante über Mage unter POST https://api.mage.space/v1/grok_image/generate aus. Eine Anfrage mit den Standardeinstellungen kostet 90 Gems (ca. 0,09 $), ohne Abo. Grok Image akzeptiert gespeicherte Characters und References per @handle im Prompt.
- BildAusgabe
- 2Varianten
- 90Gems pro Bild, Standard
- $0.09Ca. in USD
Überblick
Was die Grok Image API kann
Das Bildmodell Grok Imagine von xAI in zwei Stufen. Es generiert oder bearbeitet Bilder anhand von bis zu 3 Referenzbildern und behält dabei die Details der Vorlage bei. Der Sicherheitsfilter von xAI gilt.
Die Grok-Imagine-Bildmodelle von xAI in zwei Stufen, für Generierung und Bearbeitung anhand von Referenzbildern: Grok Image 2.0 (`grok-imagine-image-2.0`) als Standard und Grok Image (`grok-imagine-image`) für günstige Entwürfe. xAI hat Grok Image Quality (`grok-imagine-image-quality`) am 2. November 2026 eingestellt, und eine Anfrage mit diesem Modell wird abgelehnt. Der Sicherheitsfilter von xAI gilt.
Es akzeptiert image und additional_images als Eingaben.
Schnellstart
Die Grok Image API aufrufen
Setze MAGE_API_KEY, sende die Anfrage an /grok_image/generate und frage status_url ab, bis die Anfrage abgeschlossen ist.
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"])Modelle
model_id-Werte für Grok Image
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Ja |
Optionen
Parameter für Grok Image
Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.
| Feld | Werte |
|---|---|
| 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 |
Eingaben
Medieneingaben, die Grok Image akzeptiert
Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.
| Feld | Rolle |
|---|---|
| image | Das Referenzbild. |
| additional_images | Weitere Referenzbilder. |
Weitere Bildmodelle
Weitere APIs zur Bildgenerierung auf Mage
Guava API
Fotorealismus, der als Foto durchgeht
HiDream API
Schnell und vielseitig, mit Negativ-Prompts
Krea 2 API
Beeindruckende Ästhetik in Sekunden
Mango API
Unsere Flaggschiff-Bildfamilie
MiniMax H3 Image API
Native 16-Megapixel-Bilder, Open Weights
MOSS-Image API
Lange Prompts und zweisprachiger Text, offene Gewichte
FAQ
Häufig gestellte Fragen
Was kostet die Grok Image API?
Wie lautet der Endpunkt der Grok Image API?
Welche Grok Image-Modelle kann ich aufrufen?
Unterstützt Grok Image Referenzbilder oder Characters?
Kann ich Grok Image über Claude oder ChatGPT nutzen?
Wie lange bleiben Ergebnisse von Grok Image gespeichert?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.