Auf einen Blick
Die GPT Image 2 API führt GPT Image 2 und 2 weitere Varianten über Mage aus, unter POST https://api.mage.space/v1/gpt_image_2/generate. Eine Anfrage mit den Standardeinstellungen kostet 9 Gems (etwa 0,009 $), ohne Abo. GPT Image 2 unterstützt gespeicherte Characters und Referenzen per @handle im Prompt.
Bild
Ausgabe
3
Varianten
9
Gems pro Bild, Standard
$0.009
Ca. in USD
Überblick
Was die GPT Image 2 API kann
Die GPT-Image-Modelle von OpenAI setzen den Prompt aufs Wort um und rendern lesbaren Text. Generiere oder bearbeite Bilder anhand vieler Referenzbilder. Der Sicherheitsfilter von OpenAI greift.
GPT Image 2, GPT Image 2.5 Flare und GPT Image 2.5 Sunburst von OpenAI für Generierung und Bearbeitungen. Der Sicherheitsfilter von OpenAI greift.
Es akzeptiert image und additional_images als Eingaben.
Schnellstart
Die GPT Image 2 API aufrufen
Setze MAGE_API_KEY, sende die Anfrage an /gpt_image_2/generate und frage status_url ab, bis die Anfrage abgeschlossen ist.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/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": "gpt-image-2"
}' | 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('gpt_image_2', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'gpt-image-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("gpt_image_2", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "gpt-image-2",
})
print(request["result"]["url"])Modelle
model_id-Werte für GPT Image 2
Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.
| model_id | Name | Standard |
|---|---|---|
| gpt-image-2 | GPT Image 2 | Ja |
| gpt-image-2.5-flare | GPT Image 2.5 Flare | |
| gpt-image-2.5-sunburst | GPT Image 2.5 Sunburst |
Optionen
Parameter für GPT Image 2
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 |
Eingaben
Medieneingaben, die GPT Image 2 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. |
Regeln
Was die GPT Image 2 API vorgibt
- Jedes Modell bietet nur bestimmte `quality`-Stufen an; eine Stufe, die das gewählte Modell nicht bietet, wird abgelehnt.
Weitere Bildmodelle
Weitere APIs zur Bildgenerierung auf Mage
Bild · ab 75 Gems
Grok Image API
Grok Imagine in drei Qualitätsstufen
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 135 Gems
Mango API
Unsere Flaggschiff-Bildfamilie
Bild · ab 68 Gems
Nano Banana 2 API
Gestochen scharfer, lesbarer Text, bis zu 4K
FAQ
Häufig gestellte Fragen
Was kostet die GPT Image 2 API?
Eine GPT Image 2-Anfrage mit den Standardeinstellungen (GPT Image 2) kostet 9 Gems, etwa 0,009 $. Andere Auflösungen, Längen und Varianten verändern den Preis; die Antwort nennt die genauen Kosten. Eine fehlgeschlagene Generierung wird erstattet, eine von der Inhaltsrichtlinie von Mage blockierte nicht.
Wie lautet der Endpunkt der GPT Image 2 API?
POST https://api.mage.space/v1/gpt_image_2/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 GPT Image 2-Modelle kann ich aufrufen?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst). Standard ist GPT Image 2.
Unterstützt GPT Image 2 Referenzbilder oder Characters?
GPT Image 2 akzeptiert image und additional_images. Gespeicherte Characters und References nimmt GPT Image 2 per @handle im Prompt entgegen.
Kann ich GPT Image 2 über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frage direkt nach GPT Image 2. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er generiert.
Wie lange bleiben Ergebnisse von GPT Image 2 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.