gpt-image-2.5-sunburst API

Verwenden Sie die genaue Modell-ID gpt-image-2.5-sunburst. Das Modellfeld muss genau mit dieser Seite übereinstimmen.

Beispielausgabegpt-image-2.5-sunburstPOST /v1/images/generations

Parameter: size=1536x1024n=1

Prompt: The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

Anfrage, die dieses Beispiel erstellt hat

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

Authentifizierung und Endpunkt

Verwenden Sie einen Modelflare-API-Schlüssel mit https://modelflare.dev/v1. Der Gateway-Einstiegspunkt ist POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Erzeugen Sie ein Bild

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Notizen anfordern

GPT Image 2.5 Sunburst zielt auf eine höhere Wiedergabetreue und bessere Kontrolle bei der Erstellung und Bearbeitung ab; Behalten Sie images[], image[], mask, xhigh/max und die Ausgabesteuerung für beide Vorgänge bei.

Parameter anfordern

GPT Image 2.5 verwendet die OpenAI-kompatible Images API. Die Generierung verwendet JSON. Die Bearbeitung akzeptiert JSON-Bildreferenzen oder mehrteilige Dateien. Antworten geben Base64-Bilddaten in data[].b64_json zurück.

Feld	Erforderlich	Notizen
model	Ja	gpt-image-2.5-sunburst
prompt	Ja	Generierungs- oder Bearbeitungsanweisung, 1–32.000 Zeichen
images[]	Bedingt	Für JSON-Bearbeitungen bis zu 16 file_id- oder image_url-Objekte
images[].file_id	Bedingt	API-ID der hochgeladenen Datei
images[].image_url	Bedingt	Bild-URL oder Base64-Daten-URL; Daten-URLs sind auf 20.971.520 Zeichen begrenzt
image	Bedingt	Eine mehrteilige Quelldatei; Verwenden Sie image[] für mehrere Dateien
image[]	Bedingt	Für mehrteilige Bearbeitungen, bis zu 16 Quelldateien
mask	Nein	Alphamaske, die dem ersten Quellformat/der ersten Quellgröße entspricht und weniger als 50 MB groß ist
size	Nein	auto oder benutzerdefiniert WIDTHxHEIGHT; 16-Pixel-Multiples, Seitenverhältnis 1:3–3:1, maximaler Rand 3.840 Pixel und insgesamt 655.360–8.294.400 Pixel
quality	Nein	low / medium / high / xhigh / max / auto; Standard auto
background	Nein	auto / opaque / transparent; Transparente Hintergründe erfordern eine PNG- oder WebP-Ausgabe
output_format	Nein	png / jpeg / webp; Standard png
output_compression	Nein	0–100 für JPEG/WebP, Standard 100; wird für PNG ignoriert
moderation	Nein	auto / low; Standard auto
n	Nein	1–10 Ausgänge; Standard 1

Reaktions- und Eingabegrenzen

GPT Image 2.5 Flare und Sunburst unterstützen bis zu 16 Bearbeitungseingänge. JSON-Bearbeitungen verwenden images[] mit file_id oder image_url; Bei mehrteiligen Bearbeitungen wird image/image[] verwendet, wobei jedes Quellbild und jede Maske weniger als 50 MB groß ist. Eingabeaufforderungen umfassen 1–32.000 Zeichen; Qualität unterstützt low/medium/high/xhigh/max/auto; Die Größenregeln lauten: 16-Pixel-Vielfache, Seitenverhältnis 1:3–3:1, 3.840 Pixel maximaler Rand und 655.360–8.294.400 Gesamtpixel. Transparente Hintergründe erfordern PNG oder WebP; Die Komprimierung gilt nur für JPEG/WebP und wird für PNG ignoriert. Auflösungen über 2560x1440 sind experimentell. Lesen Sie data[].b64_json; Senden Sie nicht nur DALL·E response_format. Flare ist der schnelle, qualitativ hochwertige Standard für die alltägliche Generierung und Bearbeitung. Sunburst eignet sich für Arbeiten mit höherer Wiedergabetreue und besserer Kontrolle.

Bilder bearbeiten

GPT Image 2.5 unterstützt JSON-Bildreferenzen und mehrteilige Datei-Uploads über /v1/images/edits. JSON akzeptiert bis zu 16 Objekte mit file_id oder image_url; Multipart akzeptiert bis zu 16 Quelldateien. Mischen Sie images nicht mit image/image[] in einer Anfrage.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=xhigh" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

Antwortform

Generierte und bearbeitete Ergebnisse von data[] lesen. GPT Image 2.5 gibt Base64-Bilddaten zurück; Behandeln Sie die Antwort nicht als URL-Ausgabe.

Feld	Notizen
created	Erstellungszeit als Unix-Zeitstempel in Sekunden
data	Erstellte oder bearbeitete Bildergebnisse
data[].b64_json	Base64-kodierte Bilddaten
background	Endgültiger Hintergrundmodus: opaque oder transparent
output_format	Zurückgegebenes Bildformat: png, jpeg oder webp
quality	Verwendete Qualitätsstufe
size	Endgültige Abmessungen als WIDTHxHEIGHT

Fehler und fehlgeschlagene Aufgaben

Ungültige Modellparameter geben ein 4xx mit einer Anforderungs-ID zurück; Verwenden Sie die im ausgewählten Mustervertrag definierten Antwortfelder und Fehlermeldungen.

Unterstützter Bereich

Auf dieser Seite werden Modelflare-Modellgenerierungs- und -bearbeitungsaufrufe behandelt. Such- oder Kartenanreicherung, Sprachverwaltung und Elementbibliotheksverwaltung sind Ressourcen-APIs außerhalb dieser öffentlichen Modellaufrufoberfläche und keine erforderlichen Anforderungsfelder.

Preise und Abrechnung

Dieses Modell verwendet eine tokenbasierte Abrechnung. Den aktuellen Kundenpreis, den Referenzlistenpreis und die vollständige Spezifikation finden Sie auf der Modellpreisseite.

Hinweis

Diese Seite dokumentiert die öffentliche Schnittstelle von Modelflare. Bei den hier dargestellten Feldern und Grenzen handelt es sich um den aktuellen Vertrag.