GPT Image 2.5 Flare je edícia spoločnosti OpenAI na tvorbu a úpravu obrázkov určená na rýchlu a kvalitnú každodennú prácu. Prijíma text a obrázky a vracia obrazové výsledky. Používajte ju na vizuálne návrhy, ilustrácie, produktové koncepty a opakované tvorivé úlohy, pri ktorých sa má zadanie rýchlo zmeniť na použiteľný obrázok. Flare sa líši od Sunburst, ktorého zameranie zdôrazňuje presnosť úprav. Flare vyberte na bežnú tvorbu obrázkov a Sunburst vtedy, keď je prioritou presná úprava.
Začnite hlavným objektom, dejom, prostredím, kompozíciou a vizuálnym spracovaním. Pri ilustrácii pre kampaň vyžiadajte cyklistu prechádzajúceho cez malý most v teplom večernom svetle s výraznou siluetou a voľnou oblohou pre neskorší text. Stručné prieskumné zadanie môže ponechať estetické rozhodnutia otvorené; produkčné zadanie má pomenovať dôležité detaily a umiestnenie. Priame postupy generovania a úpravy povoľujú zadania s najviac 32 000 znakmi a jeden až desať výsledkov, čo umožňuje porovnať niekoľko variantov podľa rovnakého účelu.
Pri úprave možno dodať až šestnásť referenčných obrázkov. Každej referencii prideľte jasnú úlohu a neočakávajte, že model sám rozhodne, či obrázok predstavuje identitu objektu, scenériu alebo štýl. Maska môže viesť zmenu určitej oblasti; pri viacerých obrázkoch sa vzťahuje na prvý. Obrázok a maska musia mať zhodný formát a rozmery a maska musí obsahovať alfa kanál. Príručka vyžaduje, aby zdroj a maska mali menej než 50 MB. Maska je usmernenie, nie prísľub presného zachovania hraníc, preto uveďte požadovanú úpravu aj to, čo má zostať rozpoznateľné.
Flare podporuje kvalitu low, medium, high, xhigh, max a automatickú kvalitu, pričom auto je predvolené. Nižšia kvalita môže slúžiť na rýchly vizuálny návrh; vyššie nastavenia možno porovnať pre detaily konečného podkladu. Kvalita je nezávislá od veľkosti a kompresie výstupu. Štandardné veľkosti zahŕňajú 1 024 × 1 024, 1 536 × 1 024 a 1 024 × 1 536; dostupné sú aj automatické alebo vlastné rozmery. Orientáciu voľte podľa konečného umiestnenia a užitočného priestoru scény.
Vlastná šírka a výška musia byť násobkami šestnástich a žiadna hrana nesmie presiahnuť 3 840 pixelov. Povolený pomer je od 1:3 do 3:1 a celková plocha musí byť aspoň 655 360 a najviac 8 294 400 pixelov. Všetky štyri podmienky platia súčasne. Príručka označuje rozlíšenia nad 2 560 × 1 440 ako experimentálne. Použite platný rámec vyhovujúci kompozícii a do zadania zahrňte detaily citlivé na orez; väčšie rozlíšenie samo osebe rozloženie nezlepšuje.
Výsledný formát je predvolene PNG s alternatívami JPEG a WebP. JPEG a WebP povoľujú kompresiu od 0 do 100. Pre priehľadné pozadie vyberte PNG alebo WebP; podporované sú aj nepriehľadné a automatické pozadia. Priehľadný podklad možno vložiť do neskoršieho rozloženia, zatiaľ čo nepriehľadný obrázok zahŕňa vlastné pozadie. Formát, pozadie a kompresiu vyberajte podľa skutočnej potreby doručenia a dokončený súbor uchovajte so zadaním a vybranými nastaveniami.
Výrobca dokumentuje priame generovanie obrázkov a úpravy aj konverzačný obrazový nástroj, ktorý dokáže uchovať vybrané výsledky pre nadväzujúce zmeny. V tomto postupe môže byť akcia automatická, vynútené generovanie alebo vynútená úprava, keď je obrázok v kontexte. Streamovanie môže pred konečným výsledkom zobraziť až tri čiastočné obrázky. Tieto náhľady ukazujú postup a nie sú ďalšími hotovými výstupmi. Pri priebežnej práci pokračujte z vybraného obrázka a opíšte viditeľnú zmenu, napríklad posunutie jedného predmetu alebo úpravu farebného spracovania. Rozhranie výrobcu podporuje aj dávkové spracovanie.
Pri zamýšľanej veľkosti skontrolujte nápisy, umiestnenie predmetov, detaily objektu a kompozíciu obrázka. GPT Image môže mať stále ťažkosti s presným umiestnením textu, štruktúrovanými rozloženiami a opakovanou vizuálnou identitou naprieč generovaniami. Prijatý variant ponechajte ako ďalšiu referenciu a nasledujúcu úpravu zúžte na podstatný problém. Úloha Flare pri každodennom generovaní je užitočná pre jasnú postupnosť zadania, vizuálnych alternatív, výberu a doladenia, pričom konečný podklad sa hodnotí podľa skutočného tvorivého účelu.
", "aboutText": "GPT Image 2.5 Flare je edícia spoločnosti OpenAI na tvorbu a úpravu obrázkov určená na rýchlu a kvalitnú každodennú prácu. Prijíma text a obrázky a vracia obrazové výsledky. Používajte ju na vizuálne návrhy, ilustrácie, produktové koncepty a opakované tvorivé úlohy, pri ktorých sa má zadanie rýchlo zmeniť na použiteľný obrázok. Flare sa líši od Sunburst, ktorého zameranie zdôrazňuje presnosť úprav. Flare vyberte na bežnú tvorbu obrázkov a Sunburst vtedy, keď je prioritou presná úprava.\n\nZačnite hlavným objektom, dejom, prostredím, kompozíciou a vizuálnym spracovaním. Pri ilustrácii pre kampaň vyžiadajte cyklistu prechádzajúceho cez malý most v teplom večernom svetle s výraznou siluetou a voľnou oblohou pre neskorší text. Stručné prieskumné zadanie môže ponechať estetické rozhodnutia otvorené; produkčné zadanie má pomenovať dôležité detaily a umiestnenie. Priame postupy generovania a úpravy povoľujú zadania s najviac 32 000 znakmi a jeden až desať výsledkov, čo umožňuje porovnať niekoľko variantov podľa rovnakého účelu.\n\nPri úprave možno dodať až šestnásť referenčných obrázkov. Každej referencii prideľte jasnú úlohu a neočakávajte, že model sám rozhodne, či obrázok predstavuje identitu objektu, scenériu alebo štýl. Maska môže viesť zmenu určitej oblasti; pri viacerých obrázkoch sa vzťahuje na prvý. Obrázok a maska musia mať zhodný formát a rozmery a maska musí obsahovať alfa kanál. Príručka vyžaduje, aby zdroj a maska mali menej než 50 MB. Maska je usmernenie, nie prísľub presného zachovania hraníc, preto uveďte požadovanú úpravu aj to, čo má zostať rozpoznateľné.\n\nFlare podporuje kvalitu low, medium, high, xhigh, max a automatickú kvalitu, pričom auto je predvolené. Nižšia kvalita môže slúžiť na rýchly vizuálny návrh; vyššie nastavenia možno porovnať pre detaily konečného podkladu. Kvalita je nezávislá od veľkosti a kompresie výstupu. Štandardné veľkosti zahŕňajú 1 024 × 1 024, 1 536 × 1 024 a 1 024 × 1 536; dostupné sú aj automatické alebo vlastné rozmery. Orientáciu voľte podľa konečného umiestnenia a užitočného priestoru scény.\n\nVlastná šírka a výška musia byť násobkami šestnástich a žiadna hrana nesmie presiahnuť 3 840 pixelov. Povolený pomer je od 1:3 do 3:1 a celková plocha musí byť aspoň 655 360 a najviac 8 294 400 pixelov. Všetky štyri podmienky platia súčasne. Príručka označuje rozlíšenia nad 2 560 × 1 440 ako experimentálne. Použite platný rámec vyhovujúci kompozícii a do zadania zahrňte detaily citlivé na orez; väčšie rozlíšenie samo osebe rozloženie nezlepšuje.\n\nVýsledný formát je predvolene PNG s alternatívami JPEG a WebP. JPEG a WebP povoľujú kompresiu od 0 do 100. Pre priehľadné pozadie vyberte PNG alebo WebP; podporované sú aj nepriehľadné a automatické pozadia. Priehľadný podklad možno vložiť do neskoršieho rozloženia, zatiaľ čo nepriehľadný obrázok zahŕňa vlastné pozadie. Formát, pozadie a kompresiu vyberajte podľa skutočnej potreby doručenia a dokončený súbor uchovajte so zadaním a vybranými nastaveniami.\n\nVýrobca dokumentuje priame generovanie obrázkov a úpravy aj konverzačný obrazový nástroj, ktorý dokáže uchovať vybrané výsledky pre nadväzujúce zmeny. V tomto postupe môže byť akcia automatická, vynútené generovanie alebo vynútená úprava, keď je obrázok v kontexte. Streamovanie môže pred konečným výsledkom zobraziť až tri čiastočné obrázky. Tieto náhľady ukazujú postup a nie sú ďalšími hotovými výstupmi. Pri priebežnej práci pokračujte z vybraného obrázka a opíšte viditeľnú zmenu, napríklad posunutie jedného predmetu alebo úpravu farebného spracovania. Rozhranie výrobcu podporuje aj dávkové spracovanie.\n\nPri zamýšľanej veľkosti skontrolujte nápisy, umiestnenie predmetov, detaily objektu a kompozíciu obrázka. GPT Image môže mať stále ťažkosti s presným umiestnením textu, štruktúrovanými rozloženiami a opakovanou vizuálnou identitou naprieč generovaniami. Prijatý variant ponechajte ako ďalšiu referenciu a nasledujúcu úpravu zúžte na podstatný problém. Úloha Flare pri každodennom generovaní je užitočná pre jasnú postupnosť zadania, vizuálnych alternatív, výberu a doladenia, pričom konečný podklad sa hodnotí podľa skutočného tvorivého účelu.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b0ba79747b44e5f8e19d35664c01341e457120f0d9ed8d10617640526f7abb19", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "gpt-image-2.5-flareGPT Image 2.5 Flare vytvára a upravuje obrázky z textu a referencií so zameraním na rýchlu každodennú vizuálnu tvorbu. Podporuje vlastné veľkosti, priehľadné pozadia, masky a úrovne kvality až po max pre návrhy, ilustrácie a podklady pre kampane.
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 Flare je edícia spoločnosti OpenAI na tvorbu a úpravu obrázkov určená na rýchlu a kvalitnú každodennú prácu. Prijíma text a obrázky a vracia obrazové výsledky. Používajte ju na vizuálne návrhy, ilustrácie, produktové koncepty a opakované tvorivé úlohy, pri ktorých sa má zadanie rýchlo zmeniť na použiteľný obrázok. Flare sa líši od Sunburst, ktorého zameranie zdôrazňuje presnosť úprav. Flare vyberte na bežnú tvorbu obrázkov a Sunburst vtedy, keď je prioritou presná úprava.
Začnite hlavným objektom, dejom, prostredím, kompozíciou a vizuálnym spracovaním. Pri ilustrácii pre kampaň vyžiadajte cyklistu prechádzajúceho cez malý most v teplom večernom svetle s výraznou siluetou a voľnou oblohou pre neskorší text. Stručné prieskumné zadanie môže ponechať estetické rozhodnutia otvorené; produkčné zadanie má pomenovať dôležité detaily a umiestnenie. Priame postupy generovania a úpravy povoľujú zadania s najviac 32 000 znakmi a jeden až desať výsledkov, čo umožňuje porovnať niekoľko variantov podľa rovnakého účelu.
Pri úprave možno dodať až šestnásť referenčných obrázkov. Každej referencii prideľte jasnú úlohu a neočakávajte, že model sám rozhodne, či obrázok predstavuje identitu objektu, scenériu alebo štýl. Maska môže viesť zmenu určitej oblasti; pri viacerých obrázkoch sa vzťahuje na prvý. Obrázok a maska musia mať zhodný formát a rozmery a maska musí obsahovať alfa kanál. Príručka vyžaduje, aby zdroj a maska mali menej než 50 MB. Maska je usmernenie, nie prísľub presného zachovania hraníc, preto uveďte požadovanú úpravu aj to, čo má zostať rozpoznateľné.
Flare podporuje kvalitu low, medium, high, xhigh, max a automatickú kvalitu, pričom auto je predvolené. Nižšia kvalita môže slúžiť na rýchly vizuálny návrh; vyššie nastavenia možno porovnať pre detaily konečného podkladu. Kvalita je nezávislá od veľkosti a kompresie výstupu. Štandardné veľkosti zahŕňajú 1 024 × 1 024, 1 536 × 1 024 a 1 024 × 1 536; dostupné sú aj automatické alebo vlastné rozmery. Orientáciu voľte podľa konečného umiestnenia a užitočného priestoru scény.
Vlastná šírka a výška musia byť násobkami šestnástich a žiadna hrana nesmie presiahnuť 3 840 pixelov. Povolený pomer je od 1:3 do 3:1 a celková plocha musí byť aspoň 655 360 a najviac 8 294 400 pixelov. Všetky štyri podmienky platia súčasne. Príručka označuje rozlíšenia nad 2 560 × 1 440 ako experimentálne. Použite platný rámec vyhovujúci kompozícii a do zadania zahrňte detaily citlivé na orez; väčšie rozlíšenie samo osebe rozloženie nezlepšuje.
Výsledný formát je predvolene PNG s alternatívami JPEG a WebP. JPEG a WebP povoľujú kompresiu od 0 do 100. Pre priehľadné pozadie vyberte PNG alebo WebP; podporované sú aj nepriehľadné a automatické pozadia. Priehľadný podklad možno vložiť do neskoršieho rozloženia, zatiaľ čo nepriehľadný obrázok zahŕňa vlastné pozadie. Formát, pozadie a kompresiu vyberajte podľa skutočnej potreby doručenia a dokončený súbor uchovajte so zadaním a vybranými nastaveniami.
Výrobca dokumentuje priame generovanie obrázkov a úpravy aj konverzačný obrazový nástroj, ktorý dokáže uchovať vybrané výsledky pre nadväzujúce zmeny. V tomto postupe môže byť akcia automatická, vynútené generovanie alebo vynútená úprava, keď je obrázok v kontexte. Streamovanie môže pred konečným výsledkom zobraziť až tri čiastočné obrázky. Tieto náhľady ukazujú postup a nie sú ďalšími hotovými výstupmi. Pri priebežnej práci pokračujte z vybraného obrázka a opíšte viditeľnú zmenu, napríklad posunutie jedného predmetu alebo úpravu farebného spracovania. Rozhranie výrobcu podporuje aj dávkové spracovanie.
Pri zamýšľanej veľkosti skontrolujte nápisy, umiestnenie predmetov, detaily objektu a kompozíciu obrázka. GPT Image môže mať stále ťažkosti s presným umiestnením textu, štruktúrovanými rozloženiami a opakovanou vizuálnou identitou naprieč generovaniami. Prijatý variant ponechajte ako ďalšiu referenciu a nasledujúcu úpravu zúžte na podstatný problém. Úloha Flare pri každodennom generovaní je užitočná pre jasnú postupnosť zadania, vizuálnych alternatív, výberu a doladenia, pričom konečný podklad sa hodnotí podľa skutočného tvorivého účelu.
POST /v1/images/generationstextimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity gpt-image-2.5-flare | 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-flare", "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-flare', '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-flare", "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-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
gpt-image-2.5-flareGPT Image 2.5 Flare vytvára a upravuje obrázky z textu a referencií so zameraním na rýchlu každodennú vizuálnu tvorbu. Podporuje vlastné veľkosti, priehľadné pozadia, masky a úrovne kvality až po max pre návrhy, ilustrácie a podklady pre kampane.
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 Flare je edícia spoločnosti OpenAI na tvorbu a úpravu obrázkov určená na rýchlu a kvalitnú každodennú prácu. Prijíma text a obrázky a vracia obrazové výsledky. Používajte ju na vizuálne návrhy, ilustrácie, produktové koncepty a opakované tvorivé úlohy, pri ktorých sa má zadanie rýchlo zmeniť na použiteľný obrázok. Flare sa líši od Sunburst, ktorého zameranie zdôrazňuje presnosť úprav. Flare vyberte na bežnú tvorbu obrázkov a Sunburst vtedy, keď je prioritou presná úprava.
Začnite hlavným objektom, dejom, prostredím, kompozíciou a vizuálnym spracovaním. Pri ilustrácii pre kampaň vyžiadajte cyklistu prechádzajúceho cez malý most v teplom večernom svetle s výraznou siluetou a voľnou oblohou pre neskorší text. Stručné prieskumné zadanie môže ponechať estetické rozhodnutia otvorené; produkčné zadanie má pomenovať dôležité detaily a umiestnenie. Priame postupy generovania a úpravy povoľujú zadania s najviac 32 000 znakmi a jeden až desať výsledkov, čo umožňuje porovnať niekoľko variantov podľa rovnakého účelu.
Pri úprave možno dodať až šestnásť referenčných obrázkov. Každej referencii prideľte jasnú úlohu a neočakávajte, že model sám rozhodne, či obrázok predstavuje identitu objektu, scenériu alebo štýl. Maska môže viesť zmenu určitej oblasti; pri viacerých obrázkoch sa vzťahuje na prvý. Obrázok a maska musia mať zhodný formát a rozmery a maska musí obsahovať alfa kanál. Príručka vyžaduje, aby zdroj a maska mali menej než 50 MB. Maska je usmernenie, nie prísľub presného zachovania hraníc, preto uveďte požadovanú úpravu aj to, čo má zostať rozpoznateľné.
Flare podporuje kvalitu low, medium, high, xhigh, max a automatickú kvalitu, pričom auto je predvolené. Nižšia kvalita môže slúžiť na rýchly vizuálny návrh; vyššie nastavenia možno porovnať pre detaily konečného podkladu. Kvalita je nezávislá od veľkosti a kompresie výstupu. Štandardné veľkosti zahŕňajú 1 024 × 1 024, 1 536 × 1 024 a 1 024 × 1 536; dostupné sú aj automatické alebo vlastné rozmery. Orientáciu voľte podľa konečného umiestnenia a užitočného priestoru scény.
Vlastná šírka a výška musia byť násobkami šestnástich a žiadna hrana nesmie presiahnuť 3 840 pixelov. Povolený pomer je od 1:3 do 3:1 a celková plocha musí byť aspoň 655 360 a najviac 8 294 400 pixelov. Všetky štyri podmienky platia súčasne. Príručka označuje rozlíšenia nad 2 560 × 1 440 ako experimentálne. Použite platný rámec vyhovujúci kompozícii a do zadania zahrňte detaily citlivé na orez; väčšie rozlíšenie samo osebe rozloženie nezlepšuje.
Výsledný formát je predvolene PNG s alternatívami JPEG a WebP. JPEG a WebP povoľujú kompresiu od 0 do 100. Pre priehľadné pozadie vyberte PNG alebo WebP; podporované sú aj nepriehľadné a automatické pozadia. Priehľadný podklad možno vložiť do neskoršieho rozloženia, zatiaľ čo nepriehľadný obrázok zahŕňa vlastné pozadie. Formát, pozadie a kompresiu vyberajte podľa skutočnej potreby doručenia a dokončený súbor uchovajte so zadaním a vybranými nastaveniami.
Výrobca dokumentuje priame generovanie obrázkov a úpravy aj konverzačný obrazový nástroj, ktorý dokáže uchovať vybrané výsledky pre nadväzujúce zmeny. V tomto postupe môže byť akcia automatická, vynútené generovanie alebo vynútená úprava, keď je obrázok v kontexte. Streamovanie môže pred konečným výsledkom zobraziť až tri čiastočné obrázky. Tieto náhľady ukazujú postup a nie sú ďalšími hotovými výstupmi. Pri priebežnej práci pokračujte z vybraného obrázka a opíšte viditeľnú zmenu, napríklad posunutie jedného predmetu alebo úpravu farebného spracovania. Rozhranie výrobcu podporuje aj dávkové spracovanie.
Pri zamýšľanej veľkosti skontrolujte nápisy, umiestnenie predmetov, detaily objektu a kompozíciu obrázka. GPT Image môže mať stále ťažkosti s presným umiestnením textu, štruktúrovanými rozloženiami a opakovanou vizuálnou identitou naprieč generovaniami. Prijatý variant ponechajte ako ďalšiu referenciu a nasledujúcu úpravu zúžte na podstatný problém. Úloha Flare pri každodennom generovaní je užitočná pre jasnú postupnosť zadania, vizuálnych alternatív, výberu a doladenia, pričom konečný podklad sa hodnotí podľa skutočného tvorivého účelu.
POST /v1/images/generationstextimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity gpt-image-2.5-flare | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Maximálna dĺžka: 32 000 | Predvolené— |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Použite auto alebo WIDTHxHEIGHT, pričom oba rozmery musia byť deliteľné 16. Najdlhšia strana má najviac 3,840 pixelov a celková veľkosť najviac 8,300,000 pixelov. | Predvolenéauto |
Polebackground | Typstring | PožiadavkaVoliteľné | Hodnoty a limity transparent, opaque, auto | Predvolenéauto |
Polemoderation | Typstring | PožiadavkaVoliteľné | Hodnoty a limity low, auto Podmienky: Na štandardnú moderáciu obsahu použite auto. | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 10 | Predvolené1 |
Polequality | Typstring | PožiadavkaVoliteľné | Hodnoty a limity auto, high, medium, low | Predvolenéauto |
Poleoutput_compression | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 0 Maximum: 100 Podmienky: Platí pre výstup JPEG a WebP; odošlite zdokumentovanú celočíselnú hodnotu. | Predvolené100 |
Poleoutput_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity webp, png, jpeg | Predvolenépng |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false Podmienky: Táto trasa vracia jednu úplnú odpoveď JSON. | Predvolenéfalse |
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciaprompt, model |
Parametermaterial_types | Špecifikáciatext |
Parameteroptional | Špecifikáciasize, background, moderation, n, quality, output_compression, output_format, stream |
Parameterconditions | ŠpecifikáciaPriehľadné pozadie vyžaduje PNG alebo WebP., Kompresia výstupu platí pre JPEG alebo WebP., Vybraná metóda generuje z textu. Úpravy a streamovanie opísané pre výrobcu sú samostatné funkcie. |
Ž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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\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\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}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nUlož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.
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.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
openai/gpt-image-2.5-flareGPT Image 2.5 Flare vytvára a upravuje obrázky z textu a referencií so zameraním na rýchlu každodennú vizuálnu tvorbu. Podporuje vlastné veľkosti, priehľadné pozadia, masky a úrovne kvality až po max pre návrhy, ilustrácie a podklady pre kampane.
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 Flare je edícia spoločnosti OpenAI na tvorbu a úpravu obrázkov určená na rýchlu a kvalitnú každodennú prácu. Prijíma text a obrázky a vracia obrazové výsledky. Používajte ju na vizuálne návrhy, ilustrácie, produktové koncepty a opakované tvorivé úlohy, pri ktorých sa má zadanie rýchlo zmeniť na použiteľný obrázok. Flare sa líši od Sunburst, ktorého zameranie zdôrazňuje presnosť úprav. Flare vyberte na bežnú tvorbu obrázkov a Sunburst vtedy, keď je prioritou presná úprava.
Začnite hlavným objektom, dejom, prostredím, kompozíciou a vizuálnym spracovaním. Pri ilustrácii pre kampaň vyžiadajte cyklistu prechádzajúceho cez malý most v teplom večernom svetle s výraznou siluetou a voľnou oblohou pre neskorší text. Stručné prieskumné zadanie môže ponechať estetické rozhodnutia otvorené; produkčné zadanie má pomenovať dôležité detaily a umiestnenie. Priame postupy generovania a úpravy povoľujú zadania s najviac 32 000 znakmi a jeden až desať výsledkov, čo umožňuje porovnať niekoľko variantov podľa rovnakého účelu.
Pri úprave možno dodať až šestnásť referenčných obrázkov. Každej referencii prideľte jasnú úlohu a neočakávajte, že model sám rozhodne, či obrázok predstavuje identitu objektu, scenériu alebo štýl. Maska môže viesť zmenu určitej oblasti; pri viacerých obrázkoch sa vzťahuje na prvý. Obrázok a maska musia mať zhodný formát a rozmery a maska musí obsahovať alfa kanál. Príručka vyžaduje, aby zdroj a maska mali menej než 50 MB. Maska je usmernenie, nie prísľub presného zachovania hraníc, preto uveďte požadovanú úpravu aj to, čo má zostať rozpoznateľné.
Flare podporuje kvalitu low, medium, high, xhigh, max a automatickú kvalitu, pričom auto je predvolené. Nižšia kvalita môže slúžiť na rýchly vizuálny návrh; vyššie nastavenia možno porovnať pre detaily konečného podkladu. Kvalita je nezávislá od veľkosti a kompresie výstupu. Štandardné veľkosti zahŕňajú 1 024 × 1 024, 1 536 × 1 024 a 1 024 × 1 536; dostupné sú aj automatické alebo vlastné rozmery. Orientáciu voľte podľa konečného umiestnenia a užitočného priestoru scény.
Vlastná šírka a výška musia byť násobkami šestnástich a žiadna hrana nesmie presiahnuť 3 840 pixelov. Povolený pomer je od 1:3 do 3:1 a celková plocha musí byť aspoň 655 360 a najviac 8 294 400 pixelov. Všetky štyri podmienky platia súčasne. Príručka označuje rozlíšenia nad 2 560 × 1 440 ako experimentálne. Použite platný rámec vyhovujúci kompozícii a do zadania zahrňte detaily citlivé na orez; väčšie rozlíšenie samo osebe rozloženie nezlepšuje.
Výsledný formát je predvolene PNG s alternatívami JPEG a WebP. JPEG a WebP povoľujú kompresiu od 0 do 100. Pre priehľadné pozadie vyberte PNG alebo WebP; podporované sú aj nepriehľadné a automatické pozadia. Priehľadný podklad možno vložiť do neskoršieho rozloženia, zatiaľ čo nepriehľadný obrázok zahŕňa vlastné pozadie. Formát, pozadie a kompresiu vyberajte podľa skutočnej potreby doručenia a dokončený súbor uchovajte so zadaním a vybranými nastaveniami.
Výrobca dokumentuje priame generovanie obrázkov a úpravy aj konverzačný obrazový nástroj, ktorý dokáže uchovať vybrané výsledky pre nadväzujúce zmeny. V tomto postupe môže byť akcia automatická, vynútené generovanie alebo vynútená úprava, keď je obrázok v kontexte. Streamovanie môže pred konečným výsledkom zobraziť až tri čiastočné obrázky. Tieto náhľady ukazujú postup a nie sú ďalšími hotovými výstupmi. Pri priebežnej práci pokračujte z vybraného obrázka a opíšte viditeľnú zmenu, napríklad posunutie jedného predmetu alebo úpravu farebného spracovania. Rozhranie výrobcu podporuje aj dávkové spracovanie.
Pri zamýšľanej veľkosti skontrolujte nápisy, umiestnenie predmetov, detaily objektu a kompozíciu obrázka. GPT Image môže mať stále ťažkosti s presným umiestnením textu, štruktúrovanými rozloženiami a opakovanou vizuálnou identitou naprieč generovaniami. Prijatý variant ponechajte ako ďalšiu referenciu a nasledujúcu úpravu zúžte na podstatný problém. Úloha Flare pri každodennom generovaní je užitočná pre jasnú postupnosť zadania, vizuálnych alternatív, výberu a doladenia, pričom konečný podklad sa hodnotí podľa skutočného tvorivého účelu.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity openai/gpt-image-2.5-flare | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Predvolené— |
Polequality | Typstring | PožiadavkaVoliteľné | Hodnoty a limity auto, low, medium, high, xhigh, max | Predvolené— |
Polebackground | Typstring | PožiadavkaVoliteľné | Hodnoty a limity auto, transparent, opaque | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 10 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 16 | Predvolené— |
Poleoutput_compression | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 0 Maximum: 100 | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-image-2.5-flare', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\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\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}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nUlož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.
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.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare