GPT Image 2.5 Sunburst je model spoločnosti OpenAI na vytváranie obrázkov. Výrobca venuje osobitnú pozornosť presnosti úprav zdrojových podkladov. Model podporuje textové zadania a v operáciách určených na tento účel aj vizuálne zdroje.
Aktuálna karta Ailoot uvádza režim vytvárania obrázka z textu. Možno určiť scénu, kompozíciu, štýl a detaily budúceho výsledku. Spôsoby práce s referenčnými obrázkami, úprav a zmien oblasti podľa masky, ktoré opisuje OpenAI, vyžadujú osobitnú podporu vstupných obrázkov; dostupnosť generovania z textu ju nepotvrdzuje.
Dostupné sú low, medium, high, xhigh, max a auto. Výber kvality riadi režim vytvárania obrázka. Líši sa od rozmerov kompozície aj stupňa kompresie výsledného súboru.
Rozmery môžu byť štvorcové, vodorovné, zvislé, vybrané automaticky alebo nastavené ručne. Pri vlastných rozmeroch musí byť každá strana násobkom 16 pixelov a nesmie prekročiť 3840 pixelov. Plocha musí byť medzi 655 360 a 8 294 400 pixelmi a pomer dlhšej strany ku kratšej nesmie prekročiť 3:1. Všetky podmienky sa uplatňujú súčasne.
Výrobca označuje rozlíšenia nad 2560x1440 ako experimentálne. Veľký obraz umožňuje zvoliť vhodný priestor pre kompozíciu, neruší však potrebu kontroly nápisov a rozmiestnenia objektov.
Predvolene sa používa PNG; dostupné sú aj JPEG a WebP. Pri JPEG a WebP možno nastaviť kompresiu. Priehľadné pozadie vyžaduje PNG alebo WebP, pretože JPEG nezachováva alfa kanál. Okrem priehľadnosti je k dispozícii nepriehľadné pozadie aj automatický výber.
Rozmery, kvalita, formát a pozadie zodpovedajú za rôzne stránky výsledku. Štýl obrázka sa určuje textovým opisom spolu s obsahom scény. Podporu konkrétnych nastavení treba posudzovať oddelene od všeobecných možností výrobcu.
Podľa OpenAI môže spracovanie zložitého zadania trvať až dve minúty. Ide o opis generovania u výrobcu, nie o záruku celkového času získania výsledku v konkrétnej aplikácii.
V osobitne podporovanej operácii úpravy maska usmerňuje zmenu vybranej oblasti. Nezaručuje presnú zhodu výsledku s hranicou, preto by prísľub presnej miestnej úpravy bol príliš silný. Použitie tohto režimu vyžaduje príslušný spôsob odovzdania zdrojového obrázka.
Pri generovaní môže model tiež nesprávne umiestniť text a detaily alebo medzi samostatnými obrázkami zmeniť vzhľad postavy. Kontrola nápisov, kompozície a opakovateľnosti patrí k overovaniu hotového súboru. Ani podrobné zadanie tieto vlastnosti nezaručuje.
", "aboutText": "### Generovanie a práca s obrázkom\n\nGPT Image 2.5 Sunburst je model spoločnosti OpenAI na vytváranie obrázkov. Výrobca venuje osobitnú pozornosť presnosti úprav zdrojových podkladov. Model podporuje textové zadania a v operáciách určených na tento účel aj vizuálne zdroje.\n\nAktuálna karta Ailoot uvádza režim vytvárania obrázka z textu. Možno určiť scénu, kompozíciu, štýl a detaily budúceho výsledku. Spôsoby práce s referenčnými obrázkami, úprav a zmien oblasti podľa masky, ktoré opisuje OpenAI, vyžadujú osobitnú podporu vstupných obrázkov; dostupnosť generovania z textu ju nepotvrdzuje.\n\n### Kvalita a tvar obrazu\n\nDostupné sú `low`, `medium`, `high`, `xhigh`, `max` a `auto`. Výber kvality riadi režim vytvárania obrázka. Líši sa od rozmerov kompozície aj stupňa kompresie výsledného súboru.\n\nRozmery môžu byť štvorcové, vodorovné, zvislé, vybrané automaticky alebo nastavené ručne. Pri vlastných rozmeroch musí byť každá strana násobkom 16 pixelov a nesmie prekročiť 3840 pixelov. Plocha musí byť medzi 655 360 a 8 294 400 pixelmi a pomer dlhšej strany ku kratšej nesmie prekročiť 3:1. Všetky podmienky sa uplatňujú súčasne.\n\nVýrobca označuje rozlíšenia nad `2560x1440` ako experimentálne. Veľký obraz umožňuje zvoliť vhodný priestor pre kompozíciu, neruší však potrebu kontroly nápisov a rozmiestnenia objektov.\n\n### Formáty výsledku a pozadie\n\nPredvolene sa používa PNG; dostupné sú aj JPEG a WebP. Pri JPEG a WebP možno nastaviť kompresiu. Priehľadné pozadie vyžaduje PNG alebo WebP, pretože JPEG nezachováva alfa kanál. Okrem priehľadnosti je k dispozícii nepriehľadné pozadie aj automatický výber.\n\nRozmery, kvalita, formát a pozadie zodpovedajú za rôzne stránky výsledku. Štýl obrázka sa určuje textovým opisom spolu s obsahom scény. Podporu konkrétnych nastavení treba posudzovať oddelene od všeobecných možností výrobcu.\n\n### Presnosť úprav a kontrola obrázka\n\nPodľa OpenAI môže spracovanie zložitého zadania trvať až dve minúty. Ide o opis generovania u výrobcu, nie o záruku celkového času získania výsledku v konkrétnej aplikácii.\n\nV osobitne podporovanej operácii úpravy maska usmerňuje zmenu vybranej oblasti. Nezaručuje presnú zhodu výsledku s hranicou, preto by prísľub presnej miestnej úpravy bol príliš silný. Použitie tohto režimu vyžaduje príslušný spôsob odovzdania zdrojového obrázka.\n\nPri generovaní môže model tiež nesprávne umiestniť text a detaily alebo medzi samostatnými obrázkami zmeniť vzhľad postavy. Kontrola nápisov, kompozície a opakovateľnosti patrí k overovaniu hotového súboru. Ani podrobné zadanie tieto vlastnosti nezaručuje.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7c383afc1ac955dd3769a1dbcb7617fa7eadeb2f507b640d12dc8da167db0c98", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "gpt-image-2.5-sunburst-2026-09-08GPT Image 2.5 Sunburst vytvára obrázky podľa textového zadania. Podporuje vlastné rozmery, rozšírené úrovne kvality a priehľadné pozadie; výrobca vyzdvihuje aj presnosť úprav.
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 vytváranie obrázkov. Výrobca venuje osobitnú pozornosť presnosti úprav zdrojových podkladov. Model podporuje textové zadania a v operáciách určených na tento účel aj vizuálne zdroje.
Aktuálna karta Ailoot uvádza režim vytvárania obrázka z textu. Možno určiť scénu, kompozíciu, štýl a detaily budúceho výsledku. Spôsoby práce s referenčnými obrázkami, úprav a zmien oblasti podľa masky, ktoré opisuje OpenAI, vyžadujú osobitnú podporu vstupných obrázkov; dostupnosť generovania z textu ju nepotvrdzuje.
Dostupné sú low, medium, high, xhigh, max a auto. Výber kvality riadi režim vytvárania obrázka. Líši sa od rozmerov kompozície aj stupňa kompresie výsledného súboru.
Rozmery môžu byť štvorcové, vodorovné, zvislé, vybrané automaticky alebo nastavené ručne. Pri vlastných rozmeroch musí byť každá strana násobkom 16 pixelov a nesmie prekročiť 3840 pixelov. Plocha musí byť medzi 655 360 a 8 294 400 pixelmi a pomer dlhšej strany ku kratšej nesmie prekročiť 3:1. Všetky podmienky sa uplatňujú súčasne.
Výrobca označuje rozlíšenia nad 2560x1440 ako experimentálne. Veľký obraz umožňuje zvoliť vhodný priestor pre kompozíciu, neruší však potrebu kontroly nápisov a rozmiestnenia objektov.
Predvolene sa používa PNG; dostupné sú aj JPEG a WebP. Pri JPEG a WebP možno nastaviť kompresiu. Priehľadné pozadie vyžaduje PNG alebo WebP, pretože JPEG nezachováva alfa kanál. Okrem priehľadnosti je k dispozícii nepriehľadné pozadie aj automatický výber.
Rozmery, kvalita, formát a pozadie zodpovedajú za rôzne stránky výsledku. Štýl obrázka sa určuje textovým opisom spolu s obsahom scény. Podporu konkrétnych nastavení treba posudzovať oddelene od všeobecných možností výrobcu.
Podľa OpenAI môže spracovanie zložitého zadania trvať až dve minúty. Ide o opis generovania u výrobcu, nie o záruku celkového času získania výsledku v konkrétnej aplikácii.
V osobitne podporovanej operácii úpravy maska usmerňuje zmenu vybranej oblasti. Nezaručuje presnú zhodu výsledku s hranicou, preto by prísľub presnej miestnej úpravy bol príliš silný. Použitie tohto režimu vyžaduje príslušný spôsob odovzdania zdrojového obrázka.
Pri generovaní môže model tiež nesprávne umiestniť text a detaily alebo medzi samostatnými obrázkami zmeniť vzhľad postavy. Kontrola nápisov, kompozície a opakovateľnosti patrí k overovaniu hotového súboru. Ani podrobné zadanie tieto vlastnosti nezaručuje.
POST /v1/images/generationstextimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity gpt-image-2.5-sunburst-2026-09-08 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 | Predvolené1 |
Poleresponse_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity url, b64_json | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polequality | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polebackground | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleoutput_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleoutput_compression | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polemoderation | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleinput_fidelity | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polestyle | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polepartial_images | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Z textu na obrázok · Povinné: prompt
| Parameter | Špecifikácia |
|---|---|
Parametermaterial_types | Špecifikáciatext |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional_controls | Špecifikácianull |
Parametercontent_type | Špecifikáciaapplication/json |
Ž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}
Štruktúry metód a ID sú presné; možnosti dodávateľa sa posudzujú oddelene od prijatia požiadavky.
POST /v1/images/generationsAiloot 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-sunburst-2026-09-08", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-sunburst-2026-09-08', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-sunburst-2026-09-08", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nStiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Uložte každú dátovú položku. Dekódujte každé b64_json alebo stiahnite obsah z každej vrátenej podpísanej URL. Príponu názvu súboru vyberte podľa skutočného typu MIME/bajtov.
Ak je potrebné skontrolovať výsledok generovania alebo úpravy obrázka, uchovajte pôvodné operation_id/X-Client-Request-ID a vrátené informácie o výsledku. Existujúce vlastné výsledky obnovte cez knižnicu médií pomocou skutočných hodnôt task_id alebo asset_id. Požiadavku na generovanie/úpravu znova neodosielajte ani nevytvárajte URL na priebežné zisťovanie stavu z operation_id.
| Pole | Typ |
|---|---|
Polecreated | Typinteger |
Poledata[].url | Typstring |
Poledata[].b64_json | Typbase64 string |
Poleusage | Typobject |
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
Ailoot gpt-image-2.5-sunburst-2026-09-08
Použite cesty metód uvedené vyššie.