A GPT Image 2 az OpenAI szöveges és vizuális bemenetből történő képgenerálásra és képszerkesztésre szolgáló modellje. Írásos leírásból új képet készít, és forrásképeket használhat szerkesztéshez vagy referenciaalapú munkához. Gyakorlati feladatai közé tartoznak az illusztrációk, termékkoncepciók, vizuális kompozíciók és meglévő anyagok módosításai. A GPT Image 2.5 Sunburst és Flare modellektől különálló kiadás, saját minőségtartománnyal és bemeneti forráshűségi működéssel.
Generáláshoz írja le a témát, a jelenetet, a kompozíciót, a fényt és a kívánt stílust. Szerkesztéshez nevezze meg, minek kell megváltoznia és minek kell megőriznie a megjelenését. Termékleírás kérhet kerámialámpát halvány felületen, középre helyezett körvonallal és a képaláírásnak hagyott hellyel; egy következő szerkesztés a lámpa alakjának és nézőpontjának megtartása mellett változtathatja meg a hátteret. A dokumentált közvetlen generálási és szerkesztési munkafolyamatok legfeljebb 32 000 karakteres promptot fogadnak, és egytől tízig terjedő számú képet adhatnak vissza.
A referenciaalapú szerkesztés legfeljebb tizenhat bemeneti képet fogad. Határozza meg minden referencia célját, hogy a téma, a háttér és a vizuális megjelenítés ne keveredjen össze. A GPT Image 2 minden képbemenetet automatikusan nagy forráshűséggel dolgoz fel; az input_fidelity paramétert el kell hagyni, mert ebben a kiadásban nem állítható. Ez eltér a GPT Image 1 high vagy low választásától és a GPT Image 1 Mini kizárólag low bemeneti forráshűségi módjától. A nagy forráshűségű bemenetfeldolgozás támogatja a forrásrészleteket, de nem garantálja minden részlet változatlan reprodukálását.
Maszkkal azonosítható a szerkesztendő terület. Az útmutató előkészítési követelményei szerint a forrásképnek és a maszknak azonos formátumúnak és méretűnek, valamint 50 MB alattinak kell lennie; a maszknak alfacsatornát is kell tartalmaznia. Több bemeneti kép esetén a maszkolás az elsőre vonatkozik. A modell a maszkot promptalapú iránymutatásként kezeli, nem szigorú geometriai határként. Írja le a helyi módosítást és a megőrzési követelményeket, majd vizsgálja meg a környező területet a nem kívánt eltérések miatt.
A GPT Image 2 low, medium, high és auto minőséget támogat, alapértelmezése auto. A 2.5 család xhigh és max beállításai nem tartoznak e kiadás minőségtartományába. A méret négyzetes, fekvő, álló, automatikus vagy érvényes egyéni szélesség és magasság lehet. A gyártó példái között 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 és 2160 × 3840 képpont szerepel. A tájolást és a részletszintet a tényleges elrendezéshez válassza meg, ne kezelje a minőséget és a méreteket ugyanazon vezérlőként.
Az egyéni méreteknek tizenhat képpont többszöröseinek kell lenniük, legfeljebb 3840 képpontos éllel, a hosszabb és rövidebb oldal legfeljebb 3:1 arányával és 655 360 és 8 294 400 képpont közötti területtel. Ezek a feltételek egyszerre érvényesek. A 2560 × 1440 feletti felbontások kísérletiként vannak megjelölve. Az egyik szabálynak megfelelő képméret egy másiknak még nem feltétlenül felel meg, ezért támogatott méretpárt válasszon, és a vágásra érzékeny elemeket írja le a leírásban.
A kimenet alapértelmezésben PNG, de JPEG és WebP is elérhető. JPEG-hez és WebP-hez 0 és 100 közötti tömörítés támogatott. A háttér nem átlátszó vagy automatikus lehet; a pontos jelenlegi referencia a GPT Image 2 átlátszóságát előzetes funkcióként írja le. Átlátszóság kérésekor használjon PNG-t vagy WebP-t, hogy az alfacsatorna megőrizhető legyen. A dokumentált streamelési munkafolyamat a kész kép előtt legfeljebb három részleges képet enged; a végső anyagot mentse el, ne a haladást jelző előnézetet. A gyártó felülete kötegelt feldolgozást is támogat.
A tényleges eredményen értékelje a szöveg olvashatóságát, a tárgyak helyzetét és a forrásrészletek megőrzését. A GPT Image számára nehézséget jelenthet a pontos feliratozás, az elrendezésérzékeny kompozíció és az ismétlődő vizuális azonosság külön generálások között. Szerkesztéssorozatnál a kiválasztott eredményt használja következő forrásként, és látható problémához kötött konkrét módosítást adjon meg. A GPT Image 2 használható kimenete egyértelmű generálási vagy szerkesztési leíráshoz kapcsolt kép, az adott feladathoz megválasztott nagy forráshűségű bemenetekkel, méretekkel és minőséggel.
", "aboutText": "A GPT Image 2 az OpenAI szöveges és vizuális bemenetből történő képgenerálásra és képszerkesztésre szolgáló modellje. Írásos leírásból új képet készít, és forrásképeket használhat szerkesztéshez vagy referenciaalapú munkához. Gyakorlati feladatai közé tartoznak az illusztrációk, termékkoncepciók, vizuális kompozíciók és meglévő anyagok módosításai. A GPT Image 2.5 Sunburst és Flare modellektől különálló kiadás, saját minőségtartománnyal és bemeneti forráshűségi működéssel.\n\nGeneráláshoz írja le a témát, a jelenetet, a kompozíciót, a fényt és a kívánt stílust. Szerkesztéshez nevezze meg, minek kell megváltoznia és minek kell megőriznie a megjelenését. Termékleírás kérhet kerámialámpát halvány felületen, középre helyezett körvonallal és a képaláírásnak hagyott hellyel; egy következő szerkesztés a lámpa alakjának és nézőpontjának megtartása mellett változtathatja meg a hátteret. A dokumentált közvetlen generálási és szerkesztési munkafolyamatok legfeljebb 32 000 karakteres promptot fogadnak, és egytől tízig terjedő számú képet adhatnak vissza.\n\nA referenciaalapú szerkesztés legfeljebb tizenhat bemeneti képet fogad. Határozza meg minden referencia célját, hogy a téma, a háttér és a vizuális megjelenítés ne keveredjen össze. A GPT Image 2 minden képbemenetet automatikusan nagy forráshűséggel dolgoz fel; az input_fidelity paramétert el kell hagyni, mert ebben a kiadásban nem állítható. Ez eltér a GPT Image 1 high vagy low választásától és a GPT Image 1 Mini kizárólag low bemeneti forráshűségi módjától. A nagy forráshűségű bemenetfeldolgozás támogatja a forrásrészleteket, de nem garantálja minden részlet változatlan reprodukálását.\n\nMaszkkal azonosítható a szerkesztendő terület. Az útmutató előkészítési követelményei szerint a forrásképnek és a maszknak azonos formátumúnak és méretűnek, valamint 50 MB alattinak kell lennie; a maszknak alfacsatornát is kell tartalmaznia. Több bemeneti kép esetén a maszkolás az elsőre vonatkozik. A modell a maszkot promptalapú iránymutatásként kezeli, nem szigorú geometriai határként. Írja le a helyi módosítást és a megőrzési követelményeket, majd vizsgálja meg a környező területet a nem kívánt eltérések miatt.\n\nA GPT Image 2 low, medium, high és auto minőséget támogat, alapértelmezése auto. A 2.5 család xhigh és max beállításai nem tartoznak e kiadás minőségtartományába. A méret négyzetes, fekvő, álló, automatikus vagy érvényes egyéni szélesség és magasság lehet. A gyártó példái között 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 és 2160 × 3840 képpont szerepel. A tájolást és a részletszintet a tényleges elrendezéshez válassza meg, ne kezelje a minőséget és a méreteket ugyanazon vezérlőként.\n\nAz egyéni méreteknek tizenhat képpont többszöröseinek kell lenniük, legfeljebb 3840 képpontos éllel, a hosszabb és rövidebb oldal legfeljebb 3:1 arányával és 655 360 és 8 294 400 képpont közötti területtel. Ezek a feltételek egyszerre érvényesek. A 2560 × 1440 feletti felbontások kísérletiként vannak megjelölve. Az egyik szabálynak megfelelő képméret egy másiknak még nem feltétlenül felel meg, ezért támogatott méretpárt válasszon, és a vágásra érzékeny elemeket írja le a leírásban.\n\nA kimenet alapértelmezésben PNG, de JPEG és WebP is elérhető. JPEG-hez és WebP-hez 0 és 100 közötti tömörítés támogatott. A háttér nem átlátszó vagy automatikus lehet; a pontos jelenlegi referencia a GPT Image 2 átlátszóságát előzetes funkcióként írja le. Átlátszóság kérésekor használjon PNG-t vagy WebP-t, hogy az alfacsatorna megőrizhető legyen. A dokumentált streamelési munkafolyamat a kész kép előtt legfeljebb három részleges képet enged; a végső anyagot mentse el, ne a haladást jelző előnézetet. A gyártó felülete kötegelt feldolgozást is támogat.\n\nA tényleges eredményen értékelje a szöveg olvashatóságát, a tárgyak helyzetét és a forrásrészletek megőrzését. A GPT Image számára nehézséget jelenthet a pontos feliratozás, az elrendezésérzékeny kompozíció és az ismétlődő vizuális azonosság külön generálások között. Szerkesztéssorozatnál a kiválasztott eredményt használja következő forrásként, és látható problémához kötött konkrét módosítást adjon meg. A GPT Image 2 használható kimenete egyértelmű generálási vagy szerkesztési leíráshoz kapcsolt kép, az adott feladathoz megválasztott nagy forráshűségű bemenetekkel, méretekkel és minőséggel.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "64eacd7cf2259a90b5fce02c77a5f0ecc6fd7a23bf3e03f9c662eec7835fd39c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "hu", "methods": [ { "html": "gpt-image-2A GPT Image 2 szövegből és vizuális referenciákból generál és szerkeszt képeket. Rugalmas képméreteket támogat, és a képbemeneteket automatikusan nagy forráshűséggel dolgozza fel, a kész anyaghoz külön minőség-, formátum- és háttérvezérlőkkel.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A GPT Image 2 az OpenAI szöveges és vizuális bemenetből történő képgenerálásra és képszerkesztésre szolgáló modellje. Írásos leírásból új képet készít, és forrásképeket használhat szerkesztéshez vagy referenciaalapú munkához. Gyakorlati feladatai közé tartoznak az illusztrációk, termékkoncepciók, vizuális kompozíciók és meglévő anyagok módosításai. A GPT Image 2.5 Sunburst és Flare modellektől különálló kiadás, saját minőségtartománnyal és bemeneti forráshűségi működéssel.
Generáláshoz írja le a témát, a jelenetet, a kompozíciót, a fényt és a kívánt stílust. Szerkesztéshez nevezze meg, minek kell megváltoznia és minek kell megőriznie a megjelenését. Termékleírás kérhet kerámialámpát halvány felületen, középre helyezett körvonallal és a képaláírásnak hagyott hellyel; egy következő szerkesztés a lámpa alakjának és nézőpontjának megtartása mellett változtathatja meg a hátteret. A dokumentált közvetlen generálási és szerkesztési munkafolyamatok legfeljebb 32 000 karakteres promptot fogadnak, és egytől tízig terjedő számú képet adhatnak vissza.
A referenciaalapú szerkesztés legfeljebb tizenhat bemeneti képet fogad. Határozza meg minden referencia célját, hogy a téma, a háttér és a vizuális megjelenítés ne keveredjen össze. A GPT Image 2 minden képbemenetet automatikusan nagy forráshűséggel dolgoz fel; az input_fidelity paramétert el kell hagyni, mert ebben a kiadásban nem állítható. Ez eltér a GPT Image 1 high vagy low választásától és a GPT Image 1 Mini kizárólag low bemeneti forráshűségi módjától. A nagy forráshűségű bemenetfeldolgozás támogatja a forrásrészleteket, de nem garantálja minden részlet változatlan reprodukálását.
Maszkkal azonosítható a szerkesztendő terület. Az útmutató előkészítési követelményei szerint a forrásképnek és a maszknak azonos formátumúnak és méretűnek, valamint 50 MB alattinak kell lennie; a maszknak alfacsatornát is kell tartalmaznia. Több bemeneti kép esetén a maszkolás az elsőre vonatkozik. A modell a maszkot promptalapú iránymutatásként kezeli, nem szigorú geometriai határként. Írja le a helyi módosítást és a megőrzési követelményeket, majd vizsgálja meg a környező területet a nem kívánt eltérések miatt.
A GPT Image 2 low, medium, high és auto minőséget támogat, alapértelmezése auto. A 2.5 család xhigh és max beállításai nem tartoznak e kiadás minőségtartományába. A méret négyzetes, fekvő, álló, automatikus vagy érvényes egyéni szélesség és magasság lehet. A gyártó példái között 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 és 2160 × 3840 képpont szerepel. A tájolást és a részletszintet a tényleges elrendezéshez válassza meg, ne kezelje a minőséget és a méreteket ugyanazon vezérlőként.
Az egyéni méreteknek tizenhat képpont többszöröseinek kell lenniük, legfeljebb 3840 képpontos éllel, a hosszabb és rövidebb oldal legfeljebb 3:1 arányával és 655 360 és 8 294 400 képpont közötti területtel. Ezek a feltételek egyszerre érvényesek. A 2560 × 1440 feletti felbontások kísérletiként vannak megjelölve. Az egyik szabálynak megfelelő képméret egy másiknak még nem feltétlenül felel meg, ezért támogatott méretpárt válasszon, és a vágásra érzékeny elemeket írja le a leírásban.
A kimenet alapértelmezésben PNG, de JPEG és WebP is elérhető. JPEG-hez és WebP-hez 0 és 100 közötti tömörítés támogatott. A háttér nem átlátszó vagy automatikus lehet; a pontos jelenlegi referencia a GPT Image 2 átlátszóságát előzetes funkcióként írja le. Átlátszóság kérésekor használjon PNG-t vagy WebP-t, hogy az alfacsatorna megőrizhető legyen. A dokumentált streamelési munkafolyamat a kész kép előtt legfeljebb három részleges képet enged; a végső anyagot mentse el, ne a haladást jelző előnézetet. A gyártó felülete kötegelt feldolgozást is támogat.
A tényleges eredményen értékelje a szöveg olvashatóságát, a tárgyak helyzetét és a forrásrészletek megőrzését. A GPT Image számára nehézséget jelenthet a pontos feliratozás, az elrendezésérzékeny kompozíció és az ismétlődő vizuális azonosság külön generálások között. Szerkesztéssorozatnál a kiválasztott eredményt használja következő forrásként, és látható problémához kötött konkrét módosítást adjon meg. A GPT Image 2 használható kimenete egyértelmű generálási vagy szerkesztési leíráshoz kapcsolt kép, az adott feladathoz megválasztott nagy forráshűségű bemenetekkel, méretekkel és minőséggel.
POST /v1/images/generationstextimage| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok gpt-image-2 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 | Alapértelmezett1 |
Mezőresponse_format | Típusstring | KövetelményOpcionális | Értékek és korlátok url, b64_json | Alapértelmezett— |
Mezőstream | Típusboolean | KövetelményOpcionális | Értékek és korlátok | Alapértelmezettfalse |
Mezősize | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőquality | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőbackground | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőoutput_format | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőoutput_compression | Típusinteger | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőmoderation | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőinput_fidelity | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőstyle | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőpartial_images | Típusinteger | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Szövegből kép · Kötelező: prompt
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional_controls | Szerződésnull |
Paramétercontent_type | Szerződésapplication/json |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
POST /v1/images/generationsAz Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
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");\nTöltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Mentsen minden adatelemet. Dekódoljon minden b64_json értéket, vagy töltse le minden visszaadott, aláírt URL tartalmát. A fájlnév kiterjesztését a tényleges MIME-típus/bájtok alapján válassza ki.
Ha egy képgenerálási vagy képszerkesztési eredmény ellenőrzést igényel, őrizze meg az eredeti operation_id/X-Client-Request-ID értéket és a visszaadott eredményadatokat. A saját, már meglévő eredményeket a médiatárból állítsa helyre a tényleges task_id vagy asset_id értékekkel. Ne küldje be újra a generálási/szerkesztési kérést, és ne állítson össze állapotlekérdezési URL-t az operation_id értékéből.
| Mező | Típus |
|---|---|
Mezőcreated | Típusinteger |
Meződata[].url | Típusstring |
Meződata[].b64_json | Típusbase64 string |
Mezőusage | Típusobject |
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
gpt-image-2A GPT Image 2 szövegből és vizuális referenciákból generál és szerkeszt képeket. Rugalmas képméreteket támogat, és a képbemeneteket automatikusan nagy forráshűséggel dolgozza fel, a kész anyaghoz külön minőség-, formátum- és háttérvezérlőkkel.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A GPT Image 2 az OpenAI szöveges és vizuális bemenetből történő képgenerálásra és képszerkesztésre szolgáló modellje. Írásos leírásból új képet készít, és forrásképeket használhat szerkesztéshez vagy referenciaalapú munkához. Gyakorlati feladatai közé tartoznak az illusztrációk, termékkoncepciók, vizuális kompozíciók és meglévő anyagok módosításai. A GPT Image 2.5 Sunburst és Flare modellektől különálló kiadás, saját minőségtartománnyal és bemeneti forráshűségi működéssel.
Generáláshoz írja le a témát, a jelenetet, a kompozíciót, a fényt és a kívánt stílust. Szerkesztéshez nevezze meg, minek kell megváltoznia és minek kell megőriznie a megjelenését. Termékleírás kérhet kerámialámpát halvány felületen, középre helyezett körvonallal és a képaláírásnak hagyott hellyel; egy következő szerkesztés a lámpa alakjának és nézőpontjának megtartása mellett változtathatja meg a hátteret. A dokumentált közvetlen generálási és szerkesztési munkafolyamatok legfeljebb 32 000 karakteres promptot fogadnak, és egytől tízig terjedő számú képet adhatnak vissza.
A referenciaalapú szerkesztés legfeljebb tizenhat bemeneti képet fogad. Határozza meg minden referencia célját, hogy a téma, a háttér és a vizuális megjelenítés ne keveredjen össze. A GPT Image 2 minden képbemenetet automatikusan nagy forráshűséggel dolgoz fel; az input_fidelity paramétert el kell hagyni, mert ebben a kiadásban nem állítható. Ez eltér a GPT Image 1 high vagy low választásától és a GPT Image 1 Mini kizárólag low bemeneti forráshűségi módjától. A nagy forráshűségű bemenetfeldolgozás támogatja a forrásrészleteket, de nem garantálja minden részlet változatlan reprodukálását.
Maszkkal azonosítható a szerkesztendő terület. Az útmutató előkészítési követelményei szerint a forrásképnek és a maszknak azonos formátumúnak és méretűnek, valamint 50 MB alattinak kell lennie; a maszknak alfacsatornát is kell tartalmaznia. Több bemeneti kép esetén a maszkolás az elsőre vonatkozik. A modell a maszkot promptalapú iránymutatásként kezeli, nem szigorú geometriai határként. Írja le a helyi módosítást és a megőrzési követelményeket, majd vizsgálja meg a környező területet a nem kívánt eltérések miatt.
A GPT Image 2 low, medium, high és auto minőséget támogat, alapértelmezése auto. A 2.5 család xhigh és max beállításai nem tartoznak e kiadás minőségtartományába. A méret négyzetes, fekvő, álló, automatikus vagy érvényes egyéni szélesség és magasság lehet. A gyártó példái között 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 és 2160 × 3840 képpont szerepel. A tájolást és a részletszintet a tényleges elrendezéshez válassza meg, ne kezelje a minőséget és a méreteket ugyanazon vezérlőként.
Az egyéni méreteknek tizenhat képpont többszöröseinek kell lenniük, legfeljebb 3840 képpontos éllel, a hosszabb és rövidebb oldal legfeljebb 3:1 arányával és 655 360 és 8 294 400 képpont közötti területtel. Ezek a feltételek egyszerre érvényesek. A 2560 × 1440 feletti felbontások kísérletiként vannak megjelölve. Az egyik szabálynak megfelelő képméret egy másiknak még nem feltétlenül felel meg, ezért támogatott méretpárt válasszon, és a vágásra érzékeny elemeket írja le a leírásban.
A kimenet alapértelmezésben PNG, de JPEG és WebP is elérhető. JPEG-hez és WebP-hez 0 és 100 közötti tömörítés támogatott. A háttér nem átlátszó vagy automatikus lehet; a pontos jelenlegi referencia a GPT Image 2 átlátszóságát előzetes funkcióként írja le. Átlátszóság kérésekor használjon PNG-t vagy WebP-t, hogy az alfacsatorna megőrizhető legyen. A dokumentált streamelési munkafolyamat a kész kép előtt legfeljebb három részleges képet enged; a végső anyagot mentse el, ne a haladást jelző előnézetet. A gyártó felülete kötegelt feldolgozást is támogat.
A tényleges eredményen értékelje a szöveg olvashatóságát, a tárgyak helyzetét és a forrásrészletek megőrzését. A GPT Image számára nehézséget jelenthet a pontos feliratozás, az elrendezésérzékeny kompozíció és az ismétlődő vizuális azonosság külön generálások között. Szerkesztéssorozatnál a kiválasztott eredményt használja következő forrásként, és látható problémához kötött konkrét módosítást adjon meg. A GPT Image 2 használható kimenete egyértelmű generálási vagy szerkesztési leíráshoz kapcsolt kép, az adott feladathoz megválasztott nagy forráshűségű bemenetekkel, méretekkel és minőséggel.
POST /v1/images/generationstextimage| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok gpt-image-2 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Maximális hossz: 32 000 | Alapértelmezett— |
Mezősize | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: Használjon auto vagy WIDTHxHEIGHT értéket úgy, hogy mindkét méret osztható legyen 16-tal. A hosszabb oldal legfeljebb 3,840 pixel, a teljes képméret legfeljebb 8,300,000 pixel lehet. | Alapértelmezettauto |
Mezőbackground | Típusstring | KövetelményOpcionális | Értékek és korlátok transparent, opaque, auto | Alapértelmezettauto |
Mezőmoderation | Típusstring | KövetelményOpcionális | Értékek és korlátok low, auto Feltételek: A szokásos tartalommoderáláshoz használja az auto értéket. | Alapértelmezett— |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 10 | Alapértelmezett1 |
Mezőquality | Típusstring | KövetelményOpcionális | Értékek és korlátok auto, high, medium, low | Alapértelmezettauto |
Mezőoutput_compression | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 0 Maximum: 100 Feltételek: JPEG- és WebP-kimenetre vonatkozik; a dokumentált egész értéket küldje el. | Alapértelmezett100 |
Mezőoutput_format | Típusstring | KövetelményOpcionális | Értékek és korlátok webp, png, jpeg | Alapértelmezettpng |
Mezőstream | Típusboolean | KövetelményOpcionális | Értékek és korlátok false Feltételek: Ez az útvonal egyetlen befejezett JSON-választ ad vissza. | Alapértelmezettfalse |
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésprompt, model |
Paramétermaterial_types | Szerződéstext |
Paraméteroptional | Szerződéssize, background, moderation, n, quality, output_compression, output_format, stream |
Paraméterconditions | SzerződésAz átlátszó háttérhez PNG vagy WebP szükséges., A kimeneti tömörítés JPEG vagy WebP esetén érvényes., A kiválasztott metódus szövegből generál. A gyártónál leírt szerkesztési és adatfolyam-vezérlők külön képességek. |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.24576 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
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\nTöltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
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.\nMentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.
Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.
| Mező | Típus |
|---|---|
Mezőcreated | Típus |
Meződata[].url | Típus |
Meződata[].b64_json | Típus |
Mezőusage | Típus |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
openai/gpt-image-2A GPT Image 2 szövegből és vizuális referenciákból generál és szerkeszt képeket. Rugalmas képméreteket támogat, és a képbemeneteket automatikusan nagy forráshűséggel dolgozza fel, a kész anyaghoz külön minőség-, formátum- és háttérvezérlőkkel.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A GPT Image 2 az OpenAI szöveges és vizuális bemenetből történő képgenerálásra és képszerkesztésre szolgáló modellje. Írásos leírásból új képet készít, és forrásképeket használhat szerkesztéshez vagy referenciaalapú munkához. Gyakorlati feladatai közé tartoznak az illusztrációk, termékkoncepciók, vizuális kompozíciók és meglévő anyagok módosításai. A GPT Image 2.5 Sunburst és Flare modellektől különálló kiadás, saját minőségtartománnyal és bemeneti forráshűségi működéssel.
Generáláshoz írja le a témát, a jelenetet, a kompozíciót, a fényt és a kívánt stílust. Szerkesztéshez nevezze meg, minek kell megváltoznia és minek kell megőriznie a megjelenését. Termékleírás kérhet kerámialámpát halvány felületen, középre helyezett körvonallal és a képaláírásnak hagyott hellyel; egy következő szerkesztés a lámpa alakjának és nézőpontjának megtartása mellett változtathatja meg a hátteret. A dokumentált közvetlen generálási és szerkesztési munkafolyamatok legfeljebb 32 000 karakteres promptot fogadnak, és egytől tízig terjedő számú képet adhatnak vissza.
A referenciaalapú szerkesztés legfeljebb tizenhat bemeneti képet fogad. Határozza meg minden referencia célját, hogy a téma, a háttér és a vizuális megjelenítés ne keveredjen össze. A GPT Image 2 minden képbemenetet automatikusan nagy forráshűséggel dolgoz fel; az input_fidelity paramétert el kell hagyni, mert ebben a kiadásban nem állítható. Ez eltér a GPT Image 1 high vagy low választásától és a GPT Image 1 Mini kizárólag low bemeneti forráshűségi módjától. A nagy forráshűségű bemenetfeldolgozás támogatja a forrásrészleteket, de nem garantálja minden részlet változatlan reprodukálását.
Maszkkal azonosítható a szerkesztendő terület. Az útmutató előkészítési követelményei szerint a forrásképnek és a maszknak azonos formátumúnak és méretűnek, valamint 50 MB alattinak kell lennie; a maszknak alfacsatornát is kell tartalmaznia. Több bemeneti kép esetén a maszkolás az elsőre vonatkozik. A modell a maszkot promptalapú iránymutatásként kezeli, nem szigorú geometriai határként. Írja le a helyi módosítást és a megőrzési követelményeket, majd vizsgálja meg a környező területet a nem kívánt eltérések miatt.
A GPT Image 2 low, medium, high és auto minőséget támogat, alapértelmezése auto. A 2.5 család xhigh és max beállításai nem tartoznak e kiadás minőségtartományába. A méret négyzetes, fekvő, álló, automatikus vagy érvényes egyéni szélesség és magasság lehet. A gyártó példái között 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 és 2160 × 3840 képpont szerepel. A tájolást és a részletszintet a tényleges elrendezéshez válassza meg, ne kezelje a minőséget és a méreteket ugyanazon vezérlőként.
Az egyéni méreteknek tizenhat képpont többszöröseinek kell lenniük, legfeljebb 3840 képpontos éllel, a hosszabb és rövidebb oldal legfeljebb 3:1 arányával és 655 360 és 8 294 400 képpont közötti területtel. Ezek a feltételek egyszerre érvényesek. A 2560 × 1440 feletti felbontások kísérletiként vannak megjelölve. Az egyik szabálynak megfelelő képméret egy másiknak még nem feltétlenül felel meg, ezért támogatott méretpárt válasszon, és a vágásra érzékeny elemeket írja le a leírásban.
A kimenet alapértelmezésben PNG, de JPEG és WebP is elérhető. JPEG-hez és WebP-hez 0 és 100 közötti tömörítés támogatott. A háttér nem átlátszó vagy automatikus lehet; a pontos jelenlegi referencia a GPT Image 2 átlátszóságát előzetes funkcióként írja le. Átlátszóság kérésekor használjon PNG-t vagy WebP-t, hogy az alfacsatorna megőrizhető legyen. A dokumentált streamelési munkafolyamat a kész kép előtt legfeljebb három részleges képet enged; a végső anyagot mentse el, ne a haladást jelző előnézetet. A gyártó felülete kötegelt feldolgozást is támogat.
A tényleges eredményen értékelje a szöveg olvashatóságát, a tárgyak helyzetét és a forrásrészletek megőrzését. A GPT Image számára nehézséget jelenthet a pontos feliratozás, az elrendezésérzékeny kompozíció és az ismétlődő vizuális azonosság külön generálások között. Szerkesztéssorozatnál a kiválasztott eredményt használja következő forrásként, és látható problémához kötött konkrét módosítást adjon meg. A GPT Image 2 használható kimenete egyértelmű generálási vagy szerkesztési leíráshoz kapcsolt kép, az adott feladathoz megválasztott nagy forráshűségű bemenetekkel, méretekkel és minőséggel.
POST /v1/images/generationstext, imageimage| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok openai/gpt-image-2 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Alapértelmezett— |
Mezőquality | Típusstring | KövetelményOpcionális | Értékek és korlátok auto, low, medium, high | Alapértelmezett— |
Mezőbackground | Típusstring | KövetelményOpcionális | Értékek és korlátok auto, opaque | Alapértelmezett— |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 10 | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 16 | Alapértelmezett— |
Mezőoutput_compression | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 0 Maximum: 100 | Alapértelmezett— |
Mezőprovider | Típusobject | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paramétermaterial_types | Szerződéstext, image |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.24576 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
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\nTöltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
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.\nMentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.
Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.
| Mező | Típus |
|---|---|
Mezőcreated | Típus |
Meződata[].url | Típus |
Meződata[].b64_json | Típus |
Mezőusage | Típus |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images