OpenAI: GPT Image 2.5 Sunburst

GPT Image 2.5 Sunburst vytvára a upravuje obrázky z textu a vizuálnych referencií s dôrazom na presnosť úprav. Podporuje masky, priebežné dolaďovanie, vlastné rozmery rámca, priehľadné pozadia a úrovne kvality od low po max.

Ailoot Ultra · Obrázky POST /v1/images/generations openai/gpt-image-2.5-sunburst

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

GPT Image 2.5 Sunburst je model spoločnosti OpenAI na tvorbu a úpravu obrázkov zameraný na presnosť. Prijíma textové a obrazové vstupy a vytvára obrazové výstupy. Použite ho, keď tvorivá úloha závisí od starostlivej úpravy existujúceho materiálu, práce s vizuálnymi referenciami alebo dolaďovania kompozície vo viacerých krokoch. Zadanie môže vytvoriť novú scénu, premeniť existujúci obrázok alebo viesť úpravu vybranej oblasti. Sunburst a Flare sú samostatné edície: Sunburst zdôrazňuje presnosť úprav, zatiaľ čo Flare je určený na rýchle každodenné generovanie.

Pri novom obrázku opíšte objekt, prostredie, kompozíciu, osvetlenie a štýl a potom určte zamýšľaný tvar a použitie. Pri produktovom koncepte vyžiadajte sklenenú lampu na kamennom povrchu s mäkkým bočným osvetlením, jasne viditeľnou siluetou a voľným miestom na nadpis. Pri úprave pomenujte zmenu a prvky, ktoré majú zostať rozpoznateľné: vymeňte pozadie, upravte svetlo alebo zmeňte materiál pri zachovaní vybranej kompozície. Priame postupy výrobcu na generovanie a úpravu povoľujú zadanie s najviac 32 000 znakmi a jeden až desať výsledkov.

Úpravy podľa referencií môžu používať až šestnásť vstupných obrázkov. Každému obrázku prideľte úlohu, aby pokyn rozlišoval objekt na zachovanie, prostredie na použitie a štýl na uplatnenie. Model môže pracovať aj s maskou označujúcou oblasť na zmenu. Zdroj a maska musia mať rovnaký formát a rozmery a maska musí obsahovať alfa kanál; príručka uvádza požiadavku na veľkosť menšiu než 50 MB. Pri viacerých zdrojových obrázkoch sa maska vzťahuje na prvý. Usmerňuje požadovanú zmenu bez záruky pevnej hranice, preto do zadania zahrňte pokyny na zachovanie prvkov a vo výsledku skontrolujte okolie.

Nastavenia kvality sú low, medium, high, xhigh, max a auto, pričom auto je predvolené. Low môže slúžiť na rýchly vizuálny návrh, zatiaľ čo vyššie nastavenia sa oplatí porovnať, keď záleží na jemných detailoch. Kvalita je oddelená od výstupných rozmerov a kompresie súboru. Štandardné veľkosti zahŕňajú 1 024 × 1 024, 1 536 × 1 024 a 1 024 × 1 536 pixelov a dostupné sú aj automatické alebo vlastné rozmery. Tvar vyberte podľa konečného rozloženia skôr, než rozhodnete o množstve detailov, ktoré obrázok potrebuje.

Vlastné rozmery musia byť násobkami šestnástich pixelov, žiadna hrana nesmie prekročiť 3 840 pixelov, pomer strán musí zostať medzi 1:3 a 3:1 a celková plocha musí byť od 655 360 do 8 294 400 pixelov. Tieto podmienky platia súčasne. Formát na šírku 3 840 × 2 160 spĺňa horný limit plochy, no samotná dlhá hrana nerobí ľubovoľnú dvojicu rozmerov platnou. Rozlíšenia nad 2 560 × 1 440 sú označené ako experimentálne. Dôležité predmety, text a užitočný voľný priestor udržujte v zamýšľanom oreze a nespoliehajte sa na viac pixelov ako riešenie kompozície.

PNG je predvolený výstupný formát; podporované sú aj JPEG a WebP. Pre JPEG a WebP možno zvoliť kompresiu od 0 do 100. Priehľadné, nepriehľadné a automatické pozadie slúžia odlišným potrebám rozloženia. Pre priehľadnosť vyberte PNG alebo WebP, aby výsledok mohol zachovať alfa kanál. Priehľadný podklad potom možno vložiť do inej kompozície, zatiaľ čo nepriehľadný obrázok dodáva vlastné pozadie. Skutočný dokončený súbor uchovajte so zadaním a vybranými nastaveniami výstupu.

OpenAI dokumentuje priame generovanie a úpravy aj konverzačný nástroj na generovanie obrázkov, ktorý dokáže uchovať predchádzajúce výsledky a uplatniť nadväzujúce pokyny. V tomto konverzačnom postupe môže byť akcia automatická, vynútené generovanie alebo vynútená úprava, keď je obrázok v kontexte. Vybraný obrázok použite ako východisko ďalšej zmeny a neprechádzajte nepozorovane na iný variant. Dokumentovaný postup streamovania môže pred konečným výsledkom doručiť až tri čiastočné obrázky; priebežný náhľad pomáha ukázať postup, no nie je hotovým podkladom. Rozhranie výrobcu podporuje aj dávkové spracovanie.

Pri zamýšľanej veľkosti zobrazenia skontrolujte upravený objekt, nápisy, umiestnenie predmetov a hranicu zmeny vedenej maskou. GPT Image môže mať stále ťažkosti s presným umiestnením textu, štruktúrovanými rozloženiami alebo konzistentnosťou opakujúcich sa objektov a prvkov značky. Cielený ďalší pokyn má pomenovať viditeľný problém a prvky na zachovanie. Sunburst je užitočný pre presný tvorivý postup vedený referenciami, ktorého konečný výstup možno posúdiť podľa konkrétneho vizuálneho zadania, s vyššou kvalitou, rozmermi a priehľadnosťou zvolenými pre daný výstup.

Ailoot Ultra · Obrázky POST /v1/images/generations openai/gpt-image-2.5-sunburst

openai/gpt-image-2.5-sunburst

OpenAI /openai/gpt-image-2.5-sunburst

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity openai/gpt-image-2.5-sunburst	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto	Predvolené—
Pole`quality`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity auto, low, medium, high, xhigh, max	Predvolené—
Pole`background`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity auto, transparent, opaque	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 10	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 16	Predvolené—
Pole`output_compression`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 0 Maximum: 100	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_types`	Špecifikáciatext, image

Životný cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.24576 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Obrázky

curl

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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.

Polia odpovede

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelov

Ailoot Ultra openai/gpt-image-2.5-sunburst

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

openai/gpt-image-2.5-sunburst

FAQ · OpenAI: GPT Image 2.5 Sunburst

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · openai/gpt-image-2.5-sunburst: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · openai/gpt-image-2.5-sunburst: model, prompt, aspect_ratio, quality, background, n, input_references, output_compression, provider
Aké limity platia?: POST /v1/images/generations · openai/gpt-image-2.5-sunburst: n.minimum: 1; n.maximum: 10; output_compression.minimum: 0; output_compression.maximum: 100

OpenAI: GPT Image 2.5 Sunburst