OpenAI: GPT Image 2.5 Sunburst
GPT Image 2.5 Sunburst genereert en bewerkt afbeeldingen op basis van tekst en visuele referenties, met de nadruk op nauwkeurige bewerking. Het ondersteunt maskers, iteratieve verfijning, aangepaste beeldformaten, transparante achtergronden en kwaliteitsniveaus van low tot en met max.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
GPT Image 2.5 Sunburst is het op precisie gerichte model van OpenAI voor het genereren en bewerken van afbeeldingen. Het accepteert tekst- en beeldinvoer en produceert afbeeldingen. Gebruik het wanneer een creatieve taak afhangt van het zorgvuldig wijzigen van bestaand materiaal, werken met visuele referenties of verfijnen van een compositie in meerdere stappen. De briefing kan een nieuwe scène maken, een bestaande afbeelding transformeren of een bewerking van een geselecteerd gebied sturen. Sunburst en Flare zijn afzonderlijke edities: Sunburst legt de nadruk op nauwkeurige bewerking, terwijl Flare is gepositioneerd voor snelle dagelijkse generatie.
Beschrijf voor een nieuwe afbeelding het onderwerp, de omgeving, compositie, belichting en stijl en geef vervolgens de beoogde vorm en toepassing aan. Vraag voor een productconcept om een glazen lamp op een stenen oppervlak met zachte zijverlichting, een duidelijk zichtbaar silhouet en vrije ruimte voor een kop. Benoem bij een bewerking de wijziging en de elementen die herkenbaar moeten blijven: vervang de achtergrond, pas het licht aan of verander een materiaal met behoud van de gekozen compositie. De directe generatie- en bewerkingsworkflows van de producent staan een prompt tot 32,000 tekens en één tot tien resultaten toe.
Bewerking met referenties kan maximaal zestien invoerafbeeldingen gebruiken. Geef elke afbeelding een rol, zodat de instructie onderscheid maakt tussen het te behouden onderwerp, de te gebruiken omgeving en de toe te passen stijl. Het model kan ook werken met een masker dat een te wijzigen gebied aangeeft. De bron en het masker moeten hetzelfde formaat en dezelfde afmetingen hebben en het masker moet een alfakanaal bevatten; de handleiding stelt een bestandsgrootte van minder dan 50 MB als eis. Bij meerdere bronafbeeldingen geldt het masker voor de eerste. Het stuurt de gevraagde wijziging zonder een harde grens te garanderen. Neem daarom aanwijzingen voor behoud op in de briefing en controleer het omliggende gebied in het resultaat.
De kwaliteitsinstellingen zijn low, medium, high, xhigh, max en auto, met auto als standaard. Low kan een snelle visuele schets ondersteunen, terwijl hogere instellingen nuttig zijn om te vergelijken wanneer fijne details belangrijk zijn. Kwaliteit staat los van uitvoerafmetingen en bestandscompressie. Standaardformaten zijn onder meer 1024 × 1024, 1536 × 1024 en 1024 × 1536 pixels; automatische of aangepaste afmetingen zijn ook beschikbaar. Kies de vorm op basis van de uiteindelijke opmaak voordat je bepaalt hoeveel detail de afbeelding nodig heeft.
Aangepaste afmetingen moeten veelvouden van zestien pixels zijn, geen van beide zijden mag langer zijn dan 3840 pixels, de beeldverhouding moet tussen 1:3 en 3:1 blijven en het totale oppervlak moet tussen 655,360 en 8,294,400 pixels liggen. Deze voorwaarden gelden samen. Een liggend formaat van 3840 × 2160 past binnen de maximale oppervlakte, maar een lange zijde op zichzelf maakt niet elk willekeurig paar afmetingen geldig. Resoluties boven 2560 × 1440 worden als experimenteel beschreven. Houd belangrijke objecten, tekst en bruikbare negatieve ruimte binnen de beoogde uitsnede, in plaats van op meer pixels te vertrouwen om de compositie op te lossen.
PNG is het standaarduitvoerformaat; JPEG en WebP worden ook ondersteund. Voor JPEG en WebP kun je compressie van 0 tot 100 kiezen. Transparante, ondoorzichtige en automatische achtergronden dienen verschillende opmaakbehoeften. Kies voor transparantie PNG of WebP, zodat het resultaat een alfakanaal kan behouden. Een transparant beeld kan daarna in een andere compositie worden geplaatst, terwijl een ondoorzichtige afbeelding haar eigen achtergrond levert. Bewaar het daadwerkelijke voltooide bestand samen met de briefing en gekozen uitvoerinstellingen.
OpenAI documenteert directe generatie en bewerking, evenals een gesprekstool voor beeldgeneratie die eerdere resultaten kan bewaren en vervolginstructies kan toepassen. In die gespreksworkflow kan de actie automatisch zijn, generatie afdwingen of bewerking afdwingen wanneer een afbeelding in de context staat. Gebruik de gekozen afbeelding als uitgangspunt voor de volgende wijziging, in plaats van ongemerkt naar een andere variant over te stappen. De gedocumenteerde streamingworkflow kan maximaal drie gedeeltelijke afbeeldingen leveren vóór het uiteindelijke resultaat; een gedeeltelijke preview helpt voortgang te tonen, maar is geen voltooid beeldbestand. De interface van de fabrikant ondersteunt ook batchverwerking.
Controleer het bewerkte onderwerp, de belettering, objectplaatsing en de grens van een gemaskeerde wijziging op de beoogde weergavegrootte. GPT Image kan nog moeite hebben met precieze tekstplaatsing, gestructureerde opmaak of consistentie tussen terugkerende onderwerpen en merkelementen. Een gerichte volgende instructie moet het zichtbare probleem en de te behouden elementen aangeven. Sunburst is nuttig voor een nauwkeurige creatieve workflow met referenties als uitgangspunt, waarvan het eindresultaat aan een concrete visuele briefing kan worden getoetst en waarvoor hogere kwaliteit, afmetingen en transparantie passend worden gekozen.
Ailoot Ultra · Afbeeldingen POST /v1/images/generations openai/gpt-image-2.5-sunburst
openai/gpt-image-2.5-sunburstAan de slag
GPT Image 2.5 Sunburst genereert en bewerkt afbeeldingen op basis van tekst en visuele referenties, met de nadruk op nauwkeurige bewerking. Het ondersteunt maskers, iteratieve verfijning, aangepaste beeldformaten, transparante achtergronden en kwaliteitsniveaus van low tot en met max.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Afbeeldingen POST /v1/images/generations
- Invoertypen
text,image- Uitvoertypen
image
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten openai/gpt-image-2.5-sunburst | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Standaard— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten auto, low, medium, high, xhigh, max | Standaard— |
Veldbackground | Typestring | VereisteOptioneel | Waarden en limieten auto, transparent, opaque | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 10 | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 0 Maximumaantal items: 16 | Standaard— |
Veldoutput_compression | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 0 Maximum: 100 | Standaard— |
Veldprovider | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parametermaterial_types | Contracttext, image |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.24576 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Afbeeldingen
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
Resultaten ophalen en opslaan
Ailoot Ultra · Afbeeldingen
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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 voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Bewaar het volledige antwoord en de headers, alle daadwerkelijke uitvoer, de oorspronkelijk geretourneerde identificatoren en alle gebruiksvelden. Herstel de oorspronkelijke bewerking zonder de aanmaakaanvraag opnieuw in te dienen.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de geretourneerde X-Client-Request-ID voor reconciliatie. Lees alleen daadwerkelijk geretourneerde task_id/asset_id-waarden of de eigen mediabibliotheek uit; bouw nooit een taak-URL op basis van de bewerkings-ID en dien de aanmaakaanvraag nooit opnieuw in.
Antwoordvelden
| Veld | Type |
|---|---|
Veldcreated | Type |
Velddata[].url | Type |
Velddata[].b64_json | Type |
Veldusage | Type |
Aliasnamen
Modelaliasnamen
Ailoot Ultra openai/gpt-image-2.5-sunburst
Aliasnamen voor methodepaden
/v1/images
Gerelateerde aanroeper-ID’s
FAQ · OpenAI: GPT Image 2.5 Sunburst
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:text,image→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:model,prompt,aspect_ratio,quality,background,n,input_references,output_compression,provider- Welke limieten gelden?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:n.minimum:1;n.maximum:10;output_compression.minimum:0;output_compression.maximum:100