Einführung
GPT Image 2.5 Sunburst Bildbearbeitung wendet gpt-image-2.5-sunburst von OpenAI auf vorhandene Bilder an. Es nimmt ein bis sechzehn Quellen, eine optionale PNG-Maske und die Option für transparenten Hintergrund an und ist das Modell, das OpenAI empfiehlt, wenn Präzision bei der Bearbeitung am meisten zählt.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| ein schriftliches Briefing | GPT Image 2.5 Sunburst Text-zu-Bild |
| ein Bild, das geändert werden soll | GPT Image 2.5 Sunburst Bildbearbeitung |
Wichtige Funktionen und Highlights
Masken, Treue und Transparenz
Eine Maske beschränkt die Neubemalung auf ihre transparenten Pixel; input_fidelity high hält Gesichter und Stoffe enger an den Quellen; background transparent liefert einen echten Alphakanal in PNG oder WebP.
Bis zu sechzehn Quellen
Personen, Umgebungen und Produkte aus bis zu sechzehn Bildern in einer Anfrage kombinieren, jede über ihre Reihenfolge im Prompt benannt. Jede Quelle fügt jedem Ausgabebild eine feste Eingabegebühr hinzu, nehmen Sie also nur die Referenzen, die zählen.
Präzision ist der Zweck
In unserer Bearbeitung mit dem karmesinroten Kleid änderte sich nur der Stoff: Spitzenärmel, Gesicht, Stuhl und das einzelne Führungslicht blieben, wo sie waren.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. Setzen Sie jedes Wort, das im Bild erscheinen soll, in doppelte Anführungszeichen und sagen Sie, wo es steht; alles andere wird als Beschreibung gelesen. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_urls | Ja | 1 bis 16 Quellbilder. Verweisen Sie im Prompt über die Reihenfolge darauf (das erste Bild, das zweite Bild). mindestens 1 Einträge · höchstens 16 Einträge |
mask_url | Nein | Optionales PNG in derselben Größe wie das erste Quellbild. Transparente Pixel markieren den neu zu malenden Bereich, deckende Pixel bleiben erhalten. |
aspect_ratio | Nein | Fünfzehn Formate von 1:3 bis 3:1, standardmäßig 1:1. Das Ergebnis erhält das gewählte Format, nicht das der Quelle, und das Format beeinflusst den Preis. |
resolution | Nein | 1k (Standard), 2k oder 4k. Ein quadratisches Bild ist 1024, 2048 oder 2880 Pixel breit; eine größere Stufe kostet mehr pro Bild. |
quality | Nein | low, medium, high (Standard), xhigh oder max. Jede Stufe bringt mehr Details, dauert länger und kostet mehr; heben Sie xhigh und max für Endfassungen auf. |
num_outputs | Nein | 1 bis 10 Bilder pro Anfrage, standardmäßig 1. Jedes Bild wird einzeln abgerechnet. |
input_fidelity | Nein | low (Standard) oder high. High hält Gesichter, Stoffe und gedruckte Details der Quellen enger ein. |
background | Nein | auto (Standard), transparent oder opaque. Transparent setzt png oder webp voraus und liefert einen echten Alphakanal. |
output_format | Nein | png (Standard), jpeg oder webp. Ändert den Preis nicht. |
output_quality | Nein | Kompressionsqualität für jpeg und webp, 0 bis 100: höhere Werte erhalten mehr Details und ergeben größere Dateien. Wird bei png nicht verwendet und ändert den Preis nicht. |
official_fallback | Nein | Standardmäßig an. Standardwert: |
Preis
Abrechnung pro Ausgabebild nach Qualität, Größenstufe und Seitenverhältnis; auf der offiziellen Route kommt für jedes Quellbild bei jeder Ausgabe ein fester Betrag hinzu. Das Angebot zeigt die Summe vor dem Absenden. Eine Anfrage nach einer einzelnen PNG-Bearbeitung in Qualität high und Größe 1k im Format 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 oder 9:16, ohne Maske, mit input fidelity low und background auto startet auf der Economy-Route zum Economy-Preis. Ist Official fallback eingeschaltet (Standard), läuft eine Anfrage, die diese Route ablehnt oder nicht abschließen kann, erneut über die offizielle Route zum offiziellen Preis; das Angebot zeigt daher den Einstiegspreis und den Höchstbetrag. Abgelehnte Anfragen werden nicht berechnet. Auf der offiziellen Route kosten lange Prompts für Eingabe-Tokens über die ersten 100 hinaus einen kleinen Aufpreis, einmal pro Anfrage; chinesischer, japanischer und koreanischer Text zählt etwa ein Token pro Zeichen.
| Spezifikation | Preis |
|---|---|
| $0.001816 / Bild |
| $0.001816 / Bild |
| $0.00244 / Bild |
| $0.00244 / Bild |
| $0.002752 / Bild |
| $0.002752 / Bild |
| $0.00304 / Bild |
| $0.00304 / Bild |
| $0.003568 / Bild |
| $0.003568 / Bild |
| $0.003808 / Bild |
| $0.003808 / Bild |
| $0.003856 / Bild |
| $0.003856 / Bild |
| $0.004192 / Bild |
| $0.004192 / Bild |
| $0.004744 / Bild |
| $0.004744 / Bild |
| $0.005104 / Bild |
| $0.00568 / Bild |
| $0.00568 / Bild |
| $0.00652 / Bild |
| $0.00652 / Bild |
| $0.007312 / Bild |
| $0.007312 / Bild |
| $0.008176 / Bild |
| $0.008176 / Bild |
| $0.008728 / Bild |
| $0.008728 / Bild |
| $0.010936 / Bild |
| $0.01396 / Bild |
| $0.01396 / Bild |
| $0.018592 / Bild |
| $0.018592 / Bild |
| $0.020998 / Bild (Mit Official fallback: bis zu $0.023992) |
| $0.020998 / Bild (Mit Official fallback: bis zu $0.023992) |
| $0.021472 / Bild |
| $0.021472 / Bild |
| $0.022 / Bild (Mit Official fallback: bis zu $0.028) |
| $0.022 / Bild (Mit Official fallback: bis zu $0.028) |
| $0.022864 / Bild (Mit Official fallback: bis zu $0.031456) |
| $0.022864 / Bild (Mit Official fallback: bis zu $0.031456) |
| $0.024136 / Bild |
| $0.024136 / Bild |
| $0.025636 / Bild (Mit Official fallback: bis zu $0.042544) |
| $0.0316 / Bild |
| $0.0316 / Bild |
| $0.034504 / Bild |
| $0.034504 / Bild |
| $0.037864 / Bild |
| $0.037864 / Bild |
| $0.043504 / Bild |
| $0.043504 / Bild |
| $0.049816 / Bild |
| $0.049816 / Bild |
| $0.054616 / Bild |
| $0.054616 / Bild |
| $0.055624 / Bild |
| $0.055624 / Bild |
| $0.059872 / Bild |
| $0.059872 / Bild |
| $0.07144 / Bild |
| $0.07144 / Bild |
| $0.075328 / Bild |
| $0.082936 / Bild |
| $0.082936 / Bild |
| $0.096472 / Bild |
| $0.096472 / Bild |
| $0.110728 / Bild |
| $0.110728 / Bild |
| $0.124624 / Bild |
| $0.124624 / Bild |
| $0.135064 / Bild |
| $0.135064 / Bild |
| $0.168976 / Bild |
| $0.002872 / Bild |
| $0.002872 / Bild |
| $0.004456 / Bild |
| $0.004456 / Bild |
| $0.005152 / Bild |
| $0.005152 / Bild |
| $0.005704 / Bild |
| $0.005704 / Bild |
| $0.006328 / Bild |
| $0.006328 / Bild |
| $0.006712 / Bild |
| $0.006712 / Bild |
| $0.007312 / Bild |
| $0.007312 / Bild |
| $0.008128 / Bild |
| $0.008128 / Bild |
| $0.009088 / Bild |
| $0.009088 / Bild |
| $0.009928 / Bild |
| $0.01108 / Bild |
| $0.01108 / Bild |
| $0.01276 / Bild |
| $0.01276 / Bild |
| $0.014176 / Bild |
| $0.014176 / Bild |
| $0.015904 / Bild |
| $0.015904 / Bild |
| $0.017296 / Bild |
| $0.017296 / Bild |
| $0.021808 / Bild |
| $0.024112 / Bild |
| $0.024112 / Bild |
| $0.03688 / Bild |
| $0.03688 / Bild |
| $0.041896 / Bild |
| $0.041896 / Bild |
| $0.043072 / Bild |
| $0.043072 / Bild |
| $0.048064 / Bild |
| $0.048064 / Bild |
| $0.055432 / Bild |
| $0.055432 / Bild |
| $0.062416 / Bild |
| $0.062416 / Bild |
| $0.062944 / Bild |
| $0.062944 / Bild |
| $0.067984 / Bild |
| $0.067984 / Bild |
| $0.07624 / Bild |
| $0.07624 / Bild |
| $0.086032 / Bild |
| $0.087496 / Bild |
| $0.087496 / Bild |
| $0.095248 / Bild |
| $0.095248 / Bild |
| $0.098968 / Bild |
| $0.098968 / Bild |
| $0.110656 / Bild |
| $0.110656 / Bild |
| $0.121312 / Bild |
| $0.121312 / Bild |
| $0.142816 / Bild |
| $0.142816 / Bild |
| $0.152632 / Bild |
| $0.171016 / Bild |
| $0.171016 / Bild |
| $0.19456 / Bild |
| $0.19456 / Bild |
| $0.220456 / Bild |
| $0.220456 / Bild |
| $0.248464 / Bild |
| $0.248464 / Bild |
| $0.274216 / Bild |
| $0.274216 / Bild |
| $0.342928 / Bild |
| $0.003736 / Bild |
| $0.003736 / Bild |
| $0.006016 / Bild |
| $0.006016 / Bild |
| $0.0076 / Bild |
| $0.0076 / Bild |
| $0.008368 / Bild |
| $0.008368 / Bild |
| $0.009304 / Bild |
| $0.009304 / Bild |
| $0.011176 / Bild |
| $0.011176 / Bild |
| $0.01192 / Bild |
| $0.01192 / Bild |
| $0.0124 / Bild |
| $0.0124 / Bild |
| $0.01324 / Bild |
| $0.01324 / Bild |
| $0.016216 / Bild |
| $0.0166 / Bild |
| $0.0166 / Bild |
| $0.02116 / Bild |
| $0.02116 / Bild |
| $0.023872 / Bild |
| $0.023872 / Bild |
| $0.026296 / Bild |
| $0.026296 / Bild |
| $0.028552 / Bild |
| $0.028552 / Bild |
| $0.032272 / Bild |
| $0.032272 / Bild |
| $0.035992 / Bild |
| $0.050776 / Bild |
| $0.050776 / Bild |
| $0.056176 / Bild |
| $0.056176 / Bild |
| $0.0652 / Bild |
| $0.0652 / Bild |
| $0.080464 / Bild |
| $0.080464 / Bild |
| $0.086752 / Bild |
| $0.086752 / Bild |
| $0.094288 / Bild |
| $0.094288 / Bild |
| $0.103984 / Bild |
| $0.103984 / Bild |
| $0.11296 / Bild |
| $0.11296 / Bild |
| $0.115576 / Bild |
| $0.115576 / Bild |
| $0.127864 / Bild |
| $0.127864 / Bild |
| $0.14272 / Bild |
| $0.14272 / Bild |
| $0.14272 / Bild |
| $0.168592 / Bild |
| $0.168592 / Bild |
| $0.184552 / Bild |
| $0.184552 / Bild |
| $0.197104 / Bild |
| $0.197104 / Bild |
| $0.201832 / Bild |
| $0.201832 / Bild |
| $0.253408 / Bild |
| $0.259552 / Bild |
| $0.259552 / Bild |
| $0.320608 / Bild |
| $0.320608 / Bild |
| $0.37588 / Bild |
| $0.37588 / Bild |
| $0.414736 / Bild |
| $0.414736 / Bild |
| $0.456544 / Bild |
| $0.456544 / Bild |
| $0.569656 / Bild |
Anwendungsfälle
Freigegebene Fotos retuschieren
Ein Kleidungsstück, eine Farbe oder das Licht in einem abgenommenen Foto ändern, ohne den Rest des Bildes anzufassen, mit oder ohne Maske.
Freisteller für Layouts
Personen und Produkte auf transparentem Hintergrund, bereit für ein Layout, eine Folie oder eine Produktseite ohne separaten Freistellungsschritt.
Produkte umfärben
Ein Produktfoto in mehreren Oberflächen oder Farben, maskiert auf das Produkt, sodass Set und Licht identisch bleiben.
Prompt-Leitfaden und Praxistipps
Die Maske passend zur Quelle bauen
Dieselbe Pixelgröße wie die erste Quelle, als PNG gespeichert, transparent nur dort, wo neu gemalt werden soll. Alles Deckende ist geschützt.
Die Schutzliste ausdrücklich halten
Nennen Sie nach der Änderung, was bleiben muss: Gesicht, Haar, Pose, Stuhl, Licht. Das Modell folgt einer geschriebenen Liste zuverlässiger als einer angedeuteten.
Bei Freistellern sagen, was bleibt
Nennen Sie das Motiv, das bleiben soll, und dass der Hintergrund vollständig transparent sein soll, und setzen Sie output_format auf png oder webp.
Den Alphakanal vor dem Layout prüfen
Öffnen Sie das zurückgegebene PNG oder WebP in Ihrem Layoutprogramm: Die leere Fläche ist ein echter Alphakanal, ein zusätzlicher Keying- oder Maskierschritt ist nicht nötig.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.5-sunburst/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.





