Zum Inhalt springen

Mage API · Bildmodell

Grok Image API

Grok Imagine in zwei Stufen

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

Auf 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_idNameStandard
grok-imagine-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0Ja

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.

FeldWerte
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

Eingaben

Medieneingaben, die Grok Image akzeptiert

Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.

FeldRolle
imageDas Referenzbild.
additional_imagesWeitere Referenzbilder.

Weitere Bildmodelle

Weitere APIs zur Bildgenerierung auf Mage

  • Bild · ab 37 Gems

    Guava API

    Fotorealismus, der als Foto durchgeht

  • Bild · ab 20 Gems

    HiDream API

    Schnell und vielseitig, mit Negativ-Prompts

  • Bild · ab 20 Gems

    Krea 2 API

    Beeindruckende Ästhetik in Sekunden

  • Bild · ab 42 Gems

    Mango API

    Unsere Flaggschiff-Bildfamilie

  • Bild · ab 15 Gems

    MiniMax H3 Image API

    Native 16-Megapixel-Bilder, Open Weights

  • Bild · ab 25 Gems

    MOSS-Image API

    Lange Prompts und zweisprachiger Text, offene Gewichte

FAQ

Häufig gestellte Fragen

Was kostet die Grok Image API?
Eine Grok-Image-Anfrage mit den Standardeinstellungen (Grok Image 2.0) kostet 90 Gems, etwa 0,09 $. Andere Auflösungen, Dauern und Varianten ändern den Preis; die Antwort nennt den genauen Betrag. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte nicht.
Wie lautet der Endpunkt der Grok Image API?
POST https://api.mage.space/v1/grok_image/generate mit einem Authorization: Bearer-Header, der deinen Mage-API-Schlüssel enthält. Die Antwort enthält eine status_url, die du für das Ergebnis abfragst.
Welche Grok Image-Modelle kann ich aufrufen?
grok-imagine-image (Grok Image), grok-imagine-image-2.0 (Grok Image 2.0). Standard ist Grok Image 2.0.
Unterstützt Grok Image Referenzbilder oder Characters?
Grok Image akzeptiert image und additional_images. Gespeicherte Characters und References nimmt Grok Image per @handle im Prompt entgegen.
Kann ich Grok Image über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frage direkt nach Grok Image. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er generiert.
Wie lange bleiben Ergebnisse von Grok Image gespeichert?
Ergebnisse und Eingaben werden 30 Tage lang gespeichert. Lade alles, was du behalten möchtest, in deinen eigenen Speicher herunter.

Starte jetzt mit Mage

Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.

CharactersCommunity