GPT Image 2 je model spoločnosti OpenAI na tvorbu a úpravu obrázkov z textových a vizuálnych vstupov. Vytvára nový obrázok z písomného zadania a môže použiť zdrojové obrázky na úpravy alebo prácu vedenú referenciami. Praktické úlohy zahŕňajú ilustrácie, produktové koncepty, vizuálne kompozície a zmeny existujúceho podkladu. Je to samostatná edícia odlišná od modelov GPT Image 2.5 Sunburst a Flare s vlastným rozsahom kvality a správaním vernosti vstupu.
Pri generovaní opíšte objekt, scénu, kompozíciu, svetlo a zamýšľaný štýl. Pri úprave pomenujte, čo sa má zmeniť a čo má zachovať svoj vzhľad. Produktové zadanie môže žiadať keramickú lampu na svetlom povrchu s vycentrovanou siluetou a miestom na popis; nadväzujúca úprava môže zmeniť pozadie a zachovať tvar lampy aj uhol pohľadu. Dokumentované priame postupy generovania a úpravy prijímajú zadania s najviac 32 000 znakmi a môžu vrátiť jeden až desať obrázkov.
Úprava podľa referencií prijíma až šestnásť vstupných obrázkov. Určte účel každej referencie, aby sa nezamieňal objekt, pozadie a vizuálne spracovanie. GPT Image 2 automaticky spracúva každý obrazový vstup s vysokou vernosťou; input_fidelity treba vynechať, pretože sa v tejto edícii nedá nastaviť. Tým sa líši od voľby high alebo low v GPT Image 1 a od režimu vernosti vstupu obmedzeného na low v GPT Image 1 Mini. Spracovanie vstupu s vysokou vernosťou podporuje zdrojové detaily bez záruky, že sa každý detail reprodukuje bez zmeny.
Maska môže označiť oblasť na úpravu. Zdrojový obrázok a maska musia mať rovnaký formát a rozmery a podľa požiadaviek prípravy v príručke menej než 50 MB; maska potrebuje aj alfa kanál. Ak dodáte viac vstupných obrázkov, maskovanie sa vzťahuje na prvý. Model zaobchádza s maskou ako s usmernením založeným na zadaní, nie ako s prísnou geometrickou hranicou. Opíšte miestnu zmenu a požiadavky na zachovanie prvkov a potom skontrolujte okolie, či v ňom nevznikli nechcené rozdiely.
GPT Image 2 podporuje kvalitu low, medium, high a auto, pričom auto je predvolené. Nastavenia xhigh a max z rodiny 2.5 nepatria do rozsahu kvality tejto edície. Veľkosť môže byť štvorcová, na šírku, na výšku, automatická alebo platná vlastná šírka a výška. Príklady výrobcu zahŕňajú 1 024 × 1 024, 1 536 × 1 024, 1 024 × 1 536, 2 048 × 2 048, 2 048 × 1 152, 3 840 × 2 160 a 2 160 × 3 840 pixelov. Orientáciu a úroveň detailov vyberajte pre skutočné rozloženie a nepovažujte kvalitu a rozmery za rovnaký ovládací prvok.
Vlastné rozmery musia byť násobkami šestnástich pixelov s maximálnou hranou 3 840 pixelov, pomerom dlhšej ku kratšej hrane najviac 3:1 a plochou od 655 360 do 8 294 400 pixelov. Tieto podmienky platia súčasne. Rozlíšenia nad 2 560 × 1 440 sú označené ako experimentálne. Rámec, ktorý spĺňa jedno pravidlo, môže porušiť iné, preto vyberte podporovanú dvojicu rozmerov a v zadaní opíšte prvky citlivé na orez.
Výstup je predvolene PNG; dostupné sú aj JPEG alebo WebP. Pre JPEG a WebP je podporovaná kompresia od 0 do 100. Pozadie môže byť nepriehľadné alebo automatické; konkrétna aktuálna referenčná dokumentácia opisuje priehľadnosť v GPT Image 2 ako schopnosť v režime preview. Pri požiadavke na priehľadnosť použite PNG alebo WebP, aby bolo možné zachovať alfa kanál. Dokumentovaný postup streamovania povoľuje až tri čiastočné obrázky pred hotovým obrázkom; uložte konečný podklad, nie priebežný náhľad. Rozhranie výrobcu podporuje aj dávkové spracovanie.
V skutočnom výsledku vyhodnoťte jasnosť textu, polohu predmetov a zachovanie zdrojových detailov. GPT Image môže mať ťažkosti s presnými nápismi, kompozíciami citlivými na rozloženie a opakujúcou sa vizuálnou identitou naprieč samostatnými generovaniami. Pri sérii úprav použite vybraný výsledok ako ďalší zdroj a dajte konkrétnu zmenu viazanú na viditeľný problém. Užitočným výstupom GPT Image 2 je obrázok prepojený s jasným zadaním na generovanie alebo úpravu, ktorého vstupy s vysokou vernosťou, rozmery a kvalita sú zvolené pre danú úlohu.
", "aboutText": "GPT Image 2 je model spoločnosti OpenAI na tvorbu a úpravu obrázkov z textových a vizuálnych vstupov. Vytvára nový obrázok z písomného zadania a môže použiť zdrojové obrázky na úpravy alebo prácu vedenú referenciami. Praktické úlohy zahŕňajú ilustrácie, produktové koncepty, vizuálne kompozície a zmeny existujúceho podkladu. Je to samostatná edícia odlišná od modelov GPT Image 2.5 Sunburst a Flare s vlastným rozsahom kvality a správaním vernosti vstupu.\n\nPri generovaní opíšte objekt, scénu, kompozíciu, svetlo a zamýšľaný štýl. Pri úprave pomenujte, čo sa má zmeniť a čo má zachovať svoj vzhľad. Produktové zadanie môže žiadať keramickú lampu na svetlom povrchu s vycentrovanou siluetou a miestom na popis; nadväzujúca úprava môže zmeniť pozadie a zachovať tvar lampy aj uhol pohľadu. Dokumentované priame postupy generovania a úpravy prijímajú zadania s najviac 32 000 znakmi a môžu vrátiť jeden až desať obrázkov.\n\nÚprava podľa referencií prijíma až šestnásť vstupných obrázkov. Určte účel každej referencie, aby sa nezamieňal objekt, pozadie a vizuálne spracovanie. GPT Image 2 automaticky spracúva každý obrazový vstup s vysokou vernosťou; input_fidelity treba vynechať, pretože sa v tejto edícii nedá nastaviť. Tým sa líši od voľby high alebo low v GPT Image 1 a od režimu vernosti vstupu obmedzeného na low v GPT Image 1 Mini. Spracovanie vstupu s vysokou vernosťou podporuje zdrojové detaily bez záruky, že sa každý detail reprodukuje bez zmeny.\n\nMaska môže označiť oblasť na úpravu. Zdrojový obrázok a maska musia mať rovnaký formát a rozmery a podľa požiadaviek prípravy v príručke menej než 50 MB; maska potrebuje aj alfa kanál. Ak dodáte viac vstupných obrázkov, maskovanie sa vzťahuje na prvý. Model zaobchádza s maskou ako s usmernením založeným na zadaní, nie ako s prísnou geometrickou hranicou. Opíšte miestnu zmenu a požiadavky na zachovanie prvkov a potom skontrolujte okolie, či v ňom nevznikli nechcené rozdiely.\n\nGPT Image 2 podporuje kvalitu low, medium, high a auto, pričom auto je predvolené. Nastavenia xhigh a max z rodiny 2.5 nepatria do rozsahu kvality tejto edície. Veľkosť môže byť štvorcová, na šírku, na výšku, automatická alebo platná vlastná šírka a výška. Príklady výrobcu zahŕňajú 1 024 × 1 024, 1 536 × 1 024, 1 024 × 1 536, 2 048 × 2 048, 2 048 × 1 152, 3 840 × 2 160 a 2 160 × 3 840 pixelov. Orientáciu a úroveň detailov vyberajte pre skutočné rozloženie a nepovažujte kvalitu a rozmery za rovnaký ovládací prvok.\n\nVlastné rozmery musia byť násobkami šestnástich pixelov s maximálnou hranou 3 840 pixelov, pomerom dlhšej ku kratšej hrane najviac 3:1 a plochou od 655 360 do 8 294 400 pixelov. Tieto podmienky platia súčasne. Rozlíšenia nad 2 560 × 1 440 sú označené ako experimentálne. Rámec, ktorý spĺňa jedno pravidlo, môže porušiť iné, preto vyberte podporovanú dvojicu rozmerov a v zadaní opíšte prvky citlivé na orez.\n\nVýstup je predvolene PNG; dostupné sú aj JPEG alebo WebP. Pre JPEG a WebP je podporovaná kompresia od 0 do 100. Pozadie môže byť nepriehľadné alebo automatické; konkrétna aktuálna referenčná dokumentácia opisuje priehľadnosť v GPT Image 2 ako schopnosť v režime preview. Pri požiadavke na priehľadnosť použite PNG alebo WebP, aby bolo možné zachovať alfa kanál. Dokumentovaný postup streamovania povoľuje až tri čiastočné obrázky pred hotovým obrázkom; uložte konečný podklad, nie priebežný náhľad. Rozhranie výrobcu podporuje aj dávkové spracovanie.\n\nV skutočnom výsledku vyhodnoťte jasnosť textu, polohu predmetov a zachovanie zdrojových detailov. GPT Image môže mať ťažkosti s presnými nápismi, kompozíciami citlivými na rozloženie a opakujúcou sa vizuálnou identitou naprieč samostatnými generovaniami. Pri sérii úprav použite vybraný výsledok ako ďalší zdroj a dajte konkrétnu zmenu viazanú na viditeľný problém. Užitočným výstupom GPT Image 2 je obrázok prepojený s jasným zadaním na generovanie alebo úpravu, ktorého vstupy s vysokou vernosťou, rozmery a kvalita sú zvolené pre danú úlohu.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "31bf0f92677b8dd6940d6179b8f4831673df26db30bd34c7cf6c379957a35aec", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sk", "methods": [ { "html": "gpt-image-2GPT Image 2 vytvára a upravuje obrázky z textu a vizuálnych referencií. Podporuje flexibilné rozmery rámca a automaticky spracúva obrazové vstupy s vysokou vernosťou, pričom hotový podklad má samostatné ovládanie kvality, formátu a pozadia.
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 je model spoločnosti OpenAI na tvorbu a úpravu obrázkov z textových a vizuálnych vstupov. Vytvára nový obrázok z písomného zadania a môže použiť zdrojové obrázky na úpravy alebo prácu vedenú referenciami. Praktické úlohy zahŕňajú ilustrácie, produktové koncepty, vizuálne kompozície a zmeny existujúceho podkladu. Je to samostatná edícia odlišná od modelov GPT Image 2.5 Sunburst a Flare s vlastným rozsahom kvality a správaním vernosti vstupu.
Pri generovaní opíšte objekt, scénu, kompozíciu, svetlo a zamýšľaný štýl. Pri úprave pomenujte, čo sa má zmeniť a čo má zachovať svoj vzhľad. Produktové zadanie môže žiadať keramickú lampu na svetlom povrchu s vycentrovanou siluetou a miestom na popis; nadväzujúca úprava môže zmeniť pozadie a zachovať tvar lampy aj uhol pohľadu. Dokumentované priame postupy generovania a úpravy prijímajú zadania s najviac 32 000 znakmi a môžu vrátiť jeden až desať obrázkov.
Úprava podľa referencií prijíma až šestnásť vstupných obrázkov. Určte účel každej referencie, aby sa nezamieňal objekt, pozadie a vizuálne spracovanie. GPT Image 2 automaticky spracúva každý obrazový vstup s vysokou vernosťou; input_fidelity treba vynechať, pretože sa v tejto edícii nedá nastaviť. Tým sa líši od voľby high alebo low v GPT Image 1 a od režimu vernosti vstupu obmedzeného na low v GPT Image 1 Mini. Spracovanie vstupu s vysokou vernosťou podporuje zdrojové detaily bez záruky, že sa každý detail reprodukuje bez zmeny.
Maska môže označiť oblasť na úpravu. Zdrojový obrázok a maska musia mať rovnaký formát a rozmery a podľa požiadaviek prípravy v príručke menej než 50 MB; maska potrebuje aj alfa kanál. Ak dodáte viac vstupných obrázkov, maskovanie sa vzťahuje na prvý. Model zaobchádza s maskou ako s usmernením založeným na zadaní, nie ako s prísnou geometrickou hranicou. Opíšte miestnu zmenu a požiadavky na zachovanie prvkov a potom skontrolujte okolie, či v ňom nevznikli nechcené rozdiely.
GPT Image 2 podporuje kvalitu low, medium, high a auto, pričom auto je predvolené. Nastavenia xhigh a max z rodiny 2.5 nepatria do rozsahu kvality tejto edície. Veľkosť môže byť štvorcová, na šírku, na výšku, automatická alebo platná vlastná šírka a výška. Príklady výrobcu zahŕňajú 1 024 × 1 024, 1 536 × 1 024, 1 024 × 1 536, 2 048 × 2 048, 2 048 × 1 152, 3 840 × 2 160 a 2 160 × 3 840 pixelov. Orientáciu a úroveň detailov vyberajte pre skutočné rozloženie a nepovažujte kvalitu a rozmery za rovnaký ovládací prvok.
Vlastné rozmery musia byť násobkami šestnástich pixelov s maximálnou hranou 3 840 pixelov, pomerom dlhšej ku kratšej hrane najviac 3:1 a plochou od 655 360 do 8 294 400 pixelov. Tieto podmienky platia súčasne. Rozlíšenia nad 2 560 × 1 440 sú označené ako experimentálne. Rámec, ktorý spĺňa jedno pravidlo, môže porušiť iné, preto vyberte podporovanú dvojicu rozmerov a v zadaní opíšte prvky citlivé na orez.
Výstup je predvolene PNG; dostupné sú aj JPEG alebo WebP. Pre JPEG a WebP je podporovaná kompresia od 0 do 100. Pozadie môže byť nepriehľadné alebo automatické; konkrétna aktuálna referenčná dokumentácia opisuje priehľadnosť v GPT Image 2 ako schopnosť v režime preview. Pri požiadavke na priehľadnosť použite PNG alebo WebP, aby bolo možné zachovať alfa kanál. Dokumentovaný postup streamovania povoľuje až tri čiastočné obrázky pred hotovým obrázkom; uložte konečný podklad, nie priebežný náhľad. Rozhranie výrobcu podporuje aj dávkové spracovanie.
V skutočnom výsledku vyhodnoťte jasnosť textu, polohu predmetov a zachovanie zdrojových detailov. GPT Image môže mať ťažkosti s presnými nápismi, kompozíciami citlivými na rozloženie a opakujúcou sa vizuálnou identitou naprieč samostatnými generovaniami. Pri sérii úprav použite vybraný výsledok ako ďalší zdroj a dajte konkrétnu zmenu viazanú na viditeľný problém. Užitočným výstupom GPT Image 2 je obrázok prepojený s jasným zadaním na generovanie alebo úpravu, ktorého vstupy s vysokou vernosťou, rozmery a kvalita sú zvolené pre danú úlohu.
POST /v1/images/generationstextimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity gpt-image-2 | 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", "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', '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", "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
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
gpt-image-2GPT Image 2 vytvára a upravuje obrázky z textu a vizuálnych referencií. Podporuje flexibilné rozmery rámca a automaticky spracúva obrazové vstupy s vysokou vernosťou, pričom hotový podklad má samostatné ovládanie kvality, formátu a pozadia.
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 je model spoločnosti OpenAI na tvorbu a úpravu obrázkov z textových a vizuálnych vstupov. Vytvára nový obrázok z písomného zadania a môže použiť zdrojové obrázky na úpravy alebo prácu vedenú referenciami. Praktické úlohy zahŕňajú ilustrácie, produktové koncepty, vizuálne kompozície a zmeny existujúceho podkladu. Je to samostatná edícia odlišná od modelov GPT Image 2.5 Sunburst a Flare s vlastným rozsahom kvality a správaním vernosti vstupu.
Pri generovaní opíšte objekt, scénu, kompozíciu, svetlo a zamýšľaný štýl. Pri úprave pomenujte, čo sa má zmeniť a čo má zachovať svoj vzhľad. Produktové zadanie môže žiadať keramickú lampu na svetlom povrchu s vycentrovanou siluetou a miestom na popis; nadväzujúca úprava môže zmeniť pozadie a zachovať tvar lampy aj uhol pohľadu. Dokumentované priame postupy generovania a úpravy prijímajú zadania s najviac 32 000 znakmi a môžu vrátiť jeden až desať obrázkov.
Úprava podľa referencií prijíma až šestnásť vstupných obrázkov. Určte účel každej referencie, aby sa nezamieňal objekt, pozadie a vizuálne spracovanie. GPT Image 2 automaticky spracúva každý obrazový vstup s vysokou vernosťou; input_fidelity treba vynechať, pretože sa v tejto edícii nedá nastaviť. Tým sa líši od voľby high alebo low v GPT Image 1 a od režimu vernosti vstupu obmedzeného na low v GPT Image 1 Mini. Spracovanie vstupu s vysokou vernosťou podporuje zdrojové detaily bez záruky, že sa každý detail reprodukuje bez zmeny.
Maska môže označiť oblasť na úpravu. Zdrojový obrázok a maska musia mať rovnaký formát a rozmery a podľa požiadaviek prípravy v príručke menej než 50 MB; maska potrebuje aj alfa kanál. Ak dodáte viac vstupných obrázkov, maskovanie sa vzťahuje na prvý. Model zaobchádza s maskou ako s usmernením založeným na zadaní, nie ako s prísnou geometrickou hranicou. Opíšte miestnu zmenu a požiadavky na zachovanie prvkov a potom skontrolujte okolie, či v ňom nevznikli nechcené rozdiely.
GPT Image 2 podporuje kvalitu low, medium, high a auto, pričom auto je predvolené. Nastavenia xhigh a max z rodiny 2.5 nepatria do rozsahu kvality tejto edície. Veľkosť môže byť štvorcová, na šírku, na výšku, automatická alebo platná vlastná šírka a výška. Príklady výrobcu zahŕňajú 1 024 × 1 024, 1 536 × 1 024, 1 024 × 1 536, 2 048 × 2 048, 2 048 × 1 152, 3 840 × 2 160 a 2 160 × 3 840 pixelov. Orientáciu a úroveň detailov vyberajte pre skutočné rozloženie a nepovažujte kvalitu a rozmery za rovnaký ovládací prvok.
Vlastné rozmery musia byť násobkami šestnástich pixelov s maximálnou hranou 3 840 pixelov, pomerom dlhšej ku kratšej hrane najviac 3:1 a plochou od 655 360 do 8 294 400 pixelov. Tieto podmienky platia súčasne. Rozlíšenia nad 2 560 × 1 440 sú označené ako experimentálne. Rámec, ktorý spĺňa jedno pravidlo, môže porušiť iné, preto vyberte podporovanú dvojicu rozmerov a v zadaní opíšte prvky citlivé na orez.
Výstup je predvolene PNG; dostupné sú aj JPEG alebo WebP. Pre JPEG a WebP je podporovaná kompresia od 0 do 100. Pozadie môže byť nepriehľadné alebo automatické; konkrétna aktuálna referenčná dokumentácia opisuje priehľadnosť v GPT Image 2 ako schopnosť v režime preview. Pri požiadavke na priehľadnosť použite PNG alebo WebP, aby bolo možné zachovať alfa kanál. Dokumentovaný postup streamovania povoľuje až tri čiastočné obrázky pred hotovým obrázkom; uložte konečný podklad, nie priebežný náhľad. Rozhranie výrobcu podporuje aj dávkové spracovanie.
V skutočnom výsledku vyhodnoťte jasnosť textu, polohu predmetov a zachovanie zdrojových detailov. GPT Image môže mať ťažkosti s presnými nápismi, kompozíciami citlivými na rozloženie a opakujúcou sa vizuálnou identitou naprieč samostatnými generovaniami. Pri sérii úprav použite vybraný výsledok ako ďalší zdroj a dajte konkrétnu zmenu viazanú na viditeľný problém. Užitočným výstupom GPT Image 2 je obrázok prepojený s jasným zadaním na generovanie alebo úpravu, ktorého vstupy s vysokou vernosťou, rozmery a kvalita sú zvolené pre danú úlohu.
POST /v1/images/generationstextimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity gpt-image-2 | 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', '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
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
openai/gpt-image-2GPT Image 2 vytvára a upravuje obrázky z textu a vizuálnych referencií. Podporuje flexibilné rozmery rámca a automaticky spracúva obrazové vstupy s vysokou vernosťou, pričom hotový podklad má samostatné ovládanie kvality, formátu a pozadia.
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 je model spoločnosti OpenAI na tvorbu a úpravu obrázkov z textových a vizuálnych vstupov. Vytvára nový obrázok z písomného zadania a môže použiť zdrojové obrázky na úpravy alebo prácu vedenú referenciami. Praktické úlohy zahŕňajú ilustrácie, produktové koncepty, vizuálne kompozície a zmeny existujúceho podkladu. Je to samostatná edícia odlišná od modelov GPT Image 2.5 Sunburst a Flare s vlastným rozsahom kvality a správaním vernosti vstupu.
Pri generovaní opíšte objekt, scénu, kompozíciu, svetlo a zamýšľaný štýl. Pri úprave pomenujte, čo sa má zmeniť a čo má zachovať svoj vzhľad. Produktové zadanie môže žiadať keramickú lampu na svetlom povrchu s vycentrovanou siluetou a miestom na popis; nadväzujúca úprava môže zmeniť pozadie a zachovať tvar lampy aj uhol pohľadu. Dokumentované priame postupy generovania a úpravy prijímajú zadania s najviac 32 000 znakmi a môžu vrátiť jeden až desať obrázkov.
Úprava podľa referencií prijíma až šestnásť vstupných obrázkov. Určte účel každej referencie, aby sa nezamieňal objekt, pozadie a vizuálne spracovanie. GPT Image 2 automaticky spracúva každý obrazový vstup s vysokou vernosťou; input_fidelity treba vynechať, pretože sa v tejto edícii nedá nastaviť. Tým sa líši od voľby high alebo low v GPT Image 1 a od režimu vernosti vstupu obmedzeného na low v GPT Image 1 Mini. Spracovanie vstupu s vysokou vernosťou podporuje zdrojové detaily bez záruky, že sa každý detail reprodukuje bez zmeny.
Maska môže označiť oblasť na úpravu. Zdrojový obrázok a maska musia mať rovnaký formát a rozmery a podľa požiadaviek prípravy v príručke menej než 50 MB; maska potrebuje aj alfa kanál. Ak dodáte viac vstupných obrázkov, maskovanie sa vzťahuje na prvý. Model zaobchádza s maskou ako s usmernením založeným na zadaní, nie ako s prísnou geometrickou hranicou. Opíšte miestnu zmenu a požiadavky na zachovanie prvkov a potom skontrolujte okolie, či v ňom nevznikli nechcené rozdiely.
GPT Image 2 podporuje kvalitu low, medium, high a auto, pričom auto je predvolené. Nastavenia xhigh a max z rodiny 2.5 nepatria do rozsahu kvality tejto edície. Veľkosť môže byť štvorcová, na šírku, na výšku, automatická alebo platná vlastná šírka a výška. Príklady výrobcu zahŕňajú 1 024 × 1 024, 1 536 × 1 024, 1 024 × 1 536, 2 048 × 2 048, 2 048 × 1 152, 3 840 × 2 160 a 2 160 × 3 840 pixelov. Orientáciu a úroveň detailov vyberajte pre skutočné rozloženie a nepovažujte kvalitu a rozmery za rovnaký ovládací prvok.
Vlastné rozmery musia byť násobkami šestnástich pixelov s maximálnou hranou 3 840 pixelov, pomerom dlhšej ku kratšej hrane najviac 3:1 a plochou od 655 360 do 8 294 400 pixelov. Tieto podmienky platia súčasne. Rozlíšenia nad 2 560 × 1 440 sú označené ako experimentálne. Rámec, ktorý spĺňa jedno pravidlo, môže porušiť iné, preto vyberte podporovanú dvojicu rozmerov a v zadaní opíšte prvky citlivé na orez.
Výstup je predvolene PNG; dostupné sú aj JPEG alebo WebP. Pre JPEG a WebP je podporovaná kompresia od 0 do 100. Pozadie môže byť nepriehľadné alebo automatické; konkrétna aktuálna referenčná dokumentácia opisuje priehľadnosť v GPT Image 2 ako schopnosť v režime preview. Pri požiadavke na priehľadnosť použite PNG alebo WebP, aby bolo možné zachovať alfa kanál. Dokumentovaný postup streamovania povoľuje až tri čiastočné obrázky pred hotovým obrázkom; uložte konečný podklad, nie priebežný náhľad. Rozhranie výrobcu podporuje aj dávkové spracovanie.
V skutočnom výsledku vyhodnoťte jasnosť textu, polohu predmetov a zachovanie zdrojových detailov. GPT Image môže mať ťažkosti s presnými nápismi, kompozíciami citlivými na rozloženie a opakujúcou sa vizuálnou identitou naprieč samostatnými generovaniami. Pri sérii úprav použite vybraný výsledok ako ďalší zdroj a dajte konkrétnu zmenu viazanú na viditeľný problém. Užitočným výstupom GPT Image 2 je obrázok prepojený s jasným zadaním na generovanie alebo úpravu, ktorého vstupy s vysokou vernosťou, rozmery a kvalita sú zvolené pre danú úlohu.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity openai/gpt-image-2 | 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 | Predvolené— |
Polebackground | Typstring | PožiadavkaVoliteľné | Hodnoty a limity auto, 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', '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
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images