Auf einen Blick
Die Z-Image API führt Z-Image über Mage aus, unter POST https://api.mage.space/v1/z_image/generate. Eine Anfrage mit den Standardeinstellungen kostet 10 Gems (etwa 0,01 $), ohne Abo. Z-Image unterstützt keine @handle-Erwähnungen.
Bild
Ausgabe
1
Variante
10
Gems pro Bild, Standard
$0.01
Ca. in USD
Überblick
Was die Z-Image API kann
Blitzschnell und sparsam im Gem-Verbrauch. Fotorealistisches Text-zu-Bild mit solider Anatomie und sauberer Schrift, bis zu 2K; keine Referenzbilder.
Das schnellste Bildmodell auf Mage: fotorealistisches Text-zu-Bild mit solider Anatomie und Schrift, in 1K oder 2K.
Es generiert allein anhand des Prompts.
Schnellstart
Die Z-Image API aufrufen
Setze MAGE_API_KEY, sende die Anfrage an /z_image/generate und frage status_url ab, bis sie abgeschlossen ist.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_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": "4:5",
"model_id": "z-image-turbo"
}' | 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('z_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'z-image-turbo',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("z_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo",
})
print(request["result"]["url"])Modelle
Z-Image model_id-Werte
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| z-image-turbo | Z-Image | Ja |
Optionen
Z-Image-Parameter
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 | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
Weitere Bildmodelle
Weitere APIs zur Bildgenerierung auf Mage
Bild · ab 20 Gems
Anima API
Speziell für Anime entwickelt
Bild · ab 35 Gems
Chroma API
Open-Weights-Modell auf Basis von Flux
Bild · ab 40 Gems
Flux 2 API
Lange Prompts und Bearbeitungen mit mehreren Referenzen
Bild · ab 9 Gems
GPT Image 2 API
Präzise Prompts und lesbarer Text
Bild · ab 75 Gems
Grok Image API
Grok Imagine in drei Qualitätsstufen
Bild · ab 37 Gems
Guava API
Fotorealismus, der als Foto durchgeht
FAQ
Häufig gestellte Fragen
Was kostet die Z-Image API?
Eine Z-Image-Anfrage mit den Standardeinstellungen (Z-Image) kostet 10 Gems, etwa 0,01 $. Andere Auflösungen, Längen und Varianten ändern den Preis; die Antwort nennt den genauen Betrag. Eine fehlgeschlagene Generierung wird erstattet, eine von der Content-Richtlinie von Mage blockierte nicht.
Wie lautet der Endpunkt der Z-Image API?
POST https://api.mage.space/v1/z_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 Z-Image-Modelle kann ich aufrufen?
z-image-turbo (Z-Image). Standard ist Z-Image.
Unterstützt Z-Image Referenzbilder oder Characters?
Z-Image nimmt keine Bild-, Video- oder Audioeingaben an. Z-Image unterstützt keine @handle-Erwähnungen.
Kann ich Z-Image über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frag direkt nach Z-Image. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er generiert.
Wie lange werden Ergebnisse von Z-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.