Zum Inhalt springen

Mage API · Bildmodell

GPT Image 2 API

Präzise Prompts und lesbarer Text

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

Auf einen Blick

Die GPT Image 2 API führt GPT Image 2 und 4 weitere Varianten über Mage aus, und zwar 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 akzeptiert gespeicherte Characters und Referenzen per @handle im Prompt.

  • BildAusgabe
  • 5Varianten
  • 9Gems pro Bild, Standard
  • $0.009Ca. in USD

Überblick

Was die GPT Image 2 API kann

Die GPT-Image-Modelle von OpenAI setzen den Prompt aufs Wort um und geben lesbaren Text wieder. Generiere oder bearbeite Bilder mit vielen Referenzbildern oder erstelle animierte GIFs mit GPT Image 2.6. Der Sicherheitsfilter von OpenAI gilt.

Die GPT-Image-Modelle von OpenAI für Generierung und Bearbeitung: GPT Image 2, GPT Image 2.5 Flare und Sunburst sowie GPT Image 2.6 Flare und Sunburst, die auch animierte GIFs erstellen. Der Sicherheitsfilter von OpenAI gilt.

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_idNameStandard
gpt-image-2GPT Image 2Ja
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 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.

FeldWerte
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

Eingaben

Medieneingaben, die GPT Image 2 akzeptiert

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

FeldRolle
imageDas Referenzbild.
additional_imagesWeitere 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.
  • Setze `output_format` bei einem GPT-Image-2.6-Modell auf `gif`, um ein animiertes GIF zu erhalten, mit `frame_count` von 2 bis 16 (Standard 9) und `frame_duration_ms` von 20 bis 2000 (Standard 200). Andere Modelle lehnen das ab. `resolution` gilt hier nicht: Jedes `aspect_ratio` hat eine feste Bildgröße von etwa 640 Pixeln. Das Ergebnis ist eine `.gif`-Datei, deren `type` weiterhin `image` bleibt.
  • Der Preis eines GIFs richtet sich nach `quality` und dem Bereich der Bildanzahl (2 bis 8, 9, 10 bis 12 oder 13 bis 16), nicht nach einzelnen Bildern. Die Preistabelle unten zeigt Standbilder: Den Preis eines GIFs siehst du in der Kostenschätzung.
  • Ein GIF auf Mage, zum Beispiel ein früheres Ergebnis, das du als Bild-Input übergibst, wird mit seinem ersten Frame verarbeitet. Ein GIF von woanders wird abgelehnt: Als Bild-Inputs sind nur JPEG oder PNG erlaubt.

Weitere Bildmodelle

Weitere APIs zur Bildgenerierung auf Mage

  • Bild · ab 90 Gems

    Grok Image API

    Grok Imagine in zwei Stufen

  • 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

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), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 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.

CharactersCommunity