OpenAI: GPT Image 2.5 Sunburst
GPT Image 2.5 Sunburst erzeugt und bearbeitet Bilder aus Text und visuellen Referenzen mit Schwerpunkt auf Bearbeitungspräzision. Es unterstützt Masken, iterative Verfeinerung, benutzerdefinierte Bildabmessungen, transparente Hintergründe und Qualitätsstufen von low bis max.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
GPT Image 2.5 Sunburst ist OpenAIs auf Präzision ausgerichtetes Modell für Bildgenerierung und -bearbeitung. Es akzeptiert Text- und Bildeingaben und erzeugt Bildausgaben. Verwenden Sie es, wenn eine kreative Aufgabe von sorgfältigen Änderungen an vorhandenem Material, der Arbeit mit visuellen Referenzen oder der Verfeinerung einer Komposition über mehrere Schritte abhängt. Das Briefing kann eine neue Szene erstellen, ein vorhandenes Bild transformieren oder eine Bearbeitung eines ausgewählten Bereichs lenken. Sunburst und Flare sind separate Ausgaben: Sunburst betont Bearbeitungspräzision, während Flare für schnelle alltägliche Generierung positioniert ist.
Beschreiben Sie für ein neues Bild Motiv, Umgebung, Komposition, Beleuchtung und Stil und geben Sie anschließend das geplante Format und den Verwendungszweck an. Fordern Sie für ein Produktkonzept etwa eine Glaslampe auf einer Steinoberfläche mit weichem Seitenlicht, klar sichtbarer Silhouette und Freiraum für eine Überschrift an. Benennen Sie für eine Bearbeitung die Änderung und die Elemente, die erkennbar bleiben sollen: den Hintergrund ersetzen, das Licht anpassen oder ein Material verändern und dabei die ausgewählte Komposition erhalten. Die direkten Generierungs- und Bearbeitungsabläufe des Herstellers erlauben einen Prompt mit bis zu 32.000 Zeichen und ein bis zehn Ergebnisse.
Referenzbasierte Bearbeitung kann bis zu sechzehn Eingabebilder verwenden. Geben Sie jedem Bild eine Rolle, damit die Anweisung zwischen zu erhaltendem Motiv, zu verwendender Umgebung und anzuwendendem Stil unterscheidet. Das Modell kann außerdem mit einer Maske arbeiten, die einen zu ändernden Bereich kennzeichnet. Quelle und Maske benötigen dasselbe Format und dieselben Abmessungen, und die Maske muss einen Alphakanal haben; der Leitfaden nennt eine Größenanforderung unter 50 MB. Bei mehreren Quellbildern gilt die Maske für das erste. Sie lenkt die angeforderte Änderung, statt eine harte Grenze zu garantieren; fügen Sie daher Erhaltungsvorgaben in das Briefing ein und kontrollieren Sie den umgebenden Bereich im Ergebnis.
Die Qualitätseinstellungen sind low, medium, high, xhigh, max und auto, mit auto als Standard. Low kann einen schnellen visuellen Entwurf unterstützen; höhere Einstellungen lassen sich sinnvoll vergleichen, wenn feine Details wichtig sind. Qualität ist von Ausgabeabmessungen und Dateikomprimierung getrennt. Standardgrößen umfassen 1024 × 1024, 1536 × 1024 und 1024 × 1536 Pixel; automatische oder benutzerdefinierte Abmessungen sind ebenfalls verfügbar. Wählen Sie das Format passend zum fertigen Layout, bevor Sie entscheiden, wie viel Detail das Bild benötigt.
Benutzerdefinierte Abmessungen müssen Vielfache von sechzehn Pixeln sein, keine Kante darf 3840 Pixel überschreiten, das Seitenverhältnis muss zwischen 1:3 und 3:1 bleiben und die Gesamtfläche zwischen 655.360 und 8.294.400 Pixeln liegen. Diese Bedingungen gelten gemeinsam. Ein Querformat von 3840 × 2160 passt zur oberen Flächengrenze; eine lange Kante allein macht ein beliebiges Abmessungspaar hingegen nicht gültig. Auflösungen oberhalb von 2560 × 1440 werden als experimentell beschrieben. Halten Sie wichtige Objekte, Text und nutzbaren Freiraum innerhalb des geplanten Beschnitts, statt auf mehr Pixel zur Lösung der Komposition zu vertrauen.
PNG ist das standardmäßige Ausgabeformat; JPEG und WebP werden ebenfalls unterstützt. Für JPEG und WebP lässt sich eine Komprimierung von 0 bis 100 wählen. Transparente, deckende und automatische Hintergründe dienen unterschiedlichen Layoutanforderungen. Wählen Sie für Transparenz PNG oder WebP, damit das Ergebnis einen Alphakanal erhalten kann. Ein transparentes Asset kann anschließend in einer anderen Komposition platziert werden, während ein deckendes Bild seinen eigenen Hintergrund mitbringt. Bewahren Sie die tatsächlich fertige Datei gemeinsam mit Briefing und ausgewählten Ausgabeeinstellungen auf.
OpenAI dokumentiert direkte Generierung und Bearbeitung sowie ein dialogbasiertes Bildgenerierungswerkzeug, das frühere Ergebnisse behalten und Folgeanweisungen anwenden kann. In diesem dialogbasierten Ablauf kann die Aktion automatisch, erzwungene Generierung oder erzwungene Bearbeitung sein, wenn ein Bild im Kontext liegt. Verwenden Sie das gewählte Bild als Ausgangspunkt für die nächste Änderung, statt stillschweigend auf eine andere Variante zu wechseln. Der dokumentierte Streamingablauf kann vor dem fertigen Ergebnis bis zu drei Teilbilder liefern; eine Teilvorschau macht den Fortschritt sichtbar, ist aber nicht das fertige Asset. Die Herstellerschnittstelle unterstützt außerdem Stapelverarbeitung.
Prüfen Sie bearbeitetes Motiv, Schrift, Objektplatzierung und die Grenze einer maskierten Änderung in der geplanten Anzeigegröße. GPT Image kann weiterhin Schwierigkeiten mit präziser Textpositionierung, strukturierten Layouts oder Konsistenz bei wiederkehrenden Motiven und Markenelementen haben. Eine gezielte nächste Anweisung sollte das sichtbare Problem und die zu erhaltenden Elemente benennen. Sunburst eignet sich für einen präzisen, referenzgeleiteten kreativen Ablauf, dessen fertiges Artefakt anhand eines konkreten visuellen Briefings beurteilt werden kann und für den höhere Qualität, Abmessungen und Transparenz passend zum Artefakt gewählt werden.
Ailoot Ultra · Bilder POST /v1/images/generations openai/gpt-image-2.5-sunburst
openai/gpt-image-2.5-sunburstEinstieg
GPT Image 2.5 Sunburst erzeugt und bearbeitet Bilder aus Text und visuellen Referenzen mit Schwerpunkt auf Bearbeitungspräzision. Es unterstützt Masken, iterative Verfeinerung, benutzerdefinierte Bildabmessungen, transparente Hintergründe und Qualitätsstufen von low bis max.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Bilder POST /v1/images/generations
- Eingabe
text,image- Ausgabe
image
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits openai/gpt-image-2.5-sunburst | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Standard— |
Feldquality | Typstring | AnforderungOptional | Werte und Limits auto, low, medium, high, xhigh, max | Standard— |
Feldbackground | Typstring | AnforderungOptional | Werte und Limits auto, transparent, opaque | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 10 | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 0 Maximale Anzahl Elemente: 16 | Standard— |
Feldoutput_compression | Typinteger | AnforderungOptional | Werte und Limits Minimum: 0 Maximum: 100 | Standard— |
Feldprovider | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parametermaterial_types | Vertragtext, image |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.24576 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Bilder
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-2.5-sunburst', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Bilder
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Die zurückgegebene X-Client-Request-ID zum Abgleich aufbewahren. Nur tatsächlich zurückgegebene task_id-/asset_id-Werte oder die eigene Medienbibliothek abfragen; niemals eine Aufgaben-URL aus der Vorgangs-ID bilden und die Erstellung niemals erneut anfordern.
Antwortfelder
| Feld | Typ |
|---|---|
Feldcreated | Typ |
Felddata[].url | Typ |
Felddata[].b64_json | Typ |
Feldusage | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra openai/gpt-image-2.5-sunburst
Aliasnamen für Methodenpfade
/v1/images
Zugehörige Aufrufer-IDs
FAQ · OpenAI: GPT Image 2.5 Sunburst
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:text,image→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:model,prompt,aspect_ratio,quality,background,n,input_references,output_compression,provider- Welche Grenzen gelten?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:n.minimum:1;n.maximum:10;output_compression.minimum:0;output_compression.maximum:100