GPT Image 2 on OpenAI:n malli kuvien luontiin ja muokkaukseen tekstistä ja visuaalisista syötteistä. Se luo uuden kuvan kirjallisesta briiffistä ja voi käyttää lähtökuvia muokkauksiin tai viitteiden ohjaamaan työhön. Käytännön tehtäviä ovat kuvitukset, tuotekonseptit, visuaaliset sommitelmat ja olemassa olevan aineiston muutokset. Se on erillinen versio GPT Image 2.5 Sunburst- ja Flare-malleista, ja sillä on oma laatuvalikoima ja syötteen lähdeuskollisuuden toimintatapa.
Kuvaile luontia varten kohde, näkymä, sommittelu, valo ja tarkoitettu tyyli. Nimeä muokkauksessa, minkä tulee muuttua ja minkä ulkoasun säilyä. Tuotebriiffi voi pyytää keraamista valaisinta vaalealla pinnalla, keskitettyä siluettia ja tilaa kuvatekstille; jatkomuokkaus voi vaihtaa taustan säilyttäen valaisimen muodon ja katselukulman. Dokumentoidut suorat luonti- ja muokkaustyönkulut hyväksyvät enintään 32 000 merkin kehotteet ja voivat palauttaa yhdestä kymmeneen kuvaa.
Viitteisiin perustuva muokkaus hyväksyy enintään kuusitoista syötekuvaa. Määritä kunkin viitteen tarkoitus, jotta kohde, tausta ja visuaalinen käsittely eivät sekoitu. GPT Image 2 käsittelee jokaisen kuvasyötteen automaattisesti korkealla lähdeuskollisuudella; input_fidelity tulee jättää pois, koska se ei ole säädettävissä tässä versiossa. Tämä eroaa GPT Image 1:n high- tai low-valinnasta ja GPT Image 1 Minin vain low-tason syöteuskollisuustilasta. Korkean lähdeuskollisuuden syötekäsittely tukee lähtökuvan yksityiskohtia takaamatta jokaisen yksityiskohdan muuttumatonta toistoa.
Maski voi osoittaa muokattavan alueen. Lähtökuvan ja maskin on oltava samassa muodossa ja samoissa mitoissa sekä alle 50 MB oppaan valmisteluvaatimusten mukaan; maski tarvitsee myös alfakanavan. Jos annetaan useita syötekuvia, maski koskee ensimmäistä. Malli käsittelee maskia kehotepohjaisena ohjauksena tiukan geometrisen rajan sijaan. Kuvaile paikallinen muutos ja säilyttämisvaatimukset ja tarkista sitten ympäröivä alue tahattomien erojen varalta.
GPT Image 2 tukee laatutasoja low, medium, high ja auto, ja oletus on auto. 2.5-perheen xhigh- ja max-asetukset eivät kuulu tämän version laatuvalikoimaan. Koko voi olla neliö, vaaka, pysty, automaattinen tai kelvollinen mukautettu leveys ja korkeus. Valmistajan esimerkkeihin kuuluvat 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ja 2160 × 3840 pikseliä. Valitse suunta ja yksityiskohtaisuus todellisen asettelun mukaan sen sijaan, että käsittelisit laatua ja mittoja samana säätönä.
Mukautettujen mittojen on oltava kuudentoista pikselin kerrannaisia, pisimmän sivun enintään 3840 pikseliä, pitkän ja lyhyen sivun suhteen enintään 3:1 ja pinta-alan välillä 655 360–8 294 400 pikseliä. Nämä ehdot ovat voimassa samanaikaisesti. Yli 2560 × 1440 -tarkkuudet on merkitty kokeellisiksi. Yhden säännön täyttävä koko voi silti rikkoa toista, joten valitse tuettu mittapari ja kuvaile rajaukselle herkät elementit briiffissä.
Tulos on oletuksena PNG, ja myös JPEG tai WebP ovat käytettävissä. JPEG ja WebP tukevat pakkausta väliltä 0–100. Tausta voi olla peittävä tai automaattinen; täsmällinen nykyinen viite kuvaa GPT Image 2:n läpinäkyvyyden ennakkovaiheen ominaisuudeksi. Käytä läpinäkyvyyttä pyytäessäsi PNG- tai WebP-muotoa, jotta alfakanava voidaan säilyttää. Dokumentoitu suoratoistotyönkulku sallii enintään kolme osittaista kuvaa ennen valmista kuvaa; tallenna lopullinen aineisto etenemisen esikatselun sijaan. Valmistajan rajapinta tukee myös eräkäsittelyä.
Arvioi tekstin selkeys, esineiden sijainti ja lähtöaineiston yksityiskohtien säilyminen varsinaisesta tuloksesta. GPT Imagella voi olla vaikeuksia täsmällisten tekstien, asettelulle herkkien sommitelmien ja erillisten generointien välillä toistuvan visuaalisen tunnistettavuuden kanssa. Käytä muokkaussarjassa valittua tulosta seuraavana lähtökuvana ja anna konkreettinen näkyvään ongelmaan sidottu muutos. GPT Image 2:n hyödyllinen tulos on selkeään luonti- tai muokkausbriiffiin yhdistetty kuva, jonka korkeauskolliset syötteet, mitat ja laatu valitaan kyseistä tehtävää varten.
", "aboutText": "GPT Image 2 on OpenAI:n malli kuvien luontiin ja muokkaukseen tekstistä ja visuaalisista syötteistä. Se luo uuden kuvan kirjallisesta briiffistä ja voi käyttää lähtökuvia muokkauksiin tai viitteiden ohjaamaan työhön. Käytännön tehtäviä ovat kuvitukset, tuotekonseptit, visuaaliset sommitelmat ja olemassa olevan aineiston muutokset. Se on erillinen versio GPT Image 2.5 Sunburst- ja Flare-malleista, ja sillä on oma laatuvalikoima ja syötteen lähdeuskollisuuden toimintatapa.\n\nKuvaile luontia varten kohde, näkymä, sommittelu, valo ja tarkoitettu tyyli. Nimeä muokkauksessa, minkä tulee muuttua ja minkä ulkoasun säilyä. Tuotebriiffi voi pyytää keraamista valaisinta vaalealla pinnalla, keskitettyä siluettia ja tilaa kuvatekstille; jatkomuokkaus voi vaihtaa taustan säilyttäen valaisimen muodon ja katselukulman. Dokumentoidut suorat luonti- ja muokkaustyönkulut hyväksyvät enintään 32 000 merkin kehotteet ja voivat palauttaa yhdestä kymmeneen kuvaa.\n\nViitteisiin perustuva muokkaus hyväksyy enintään kuusitoista syötekuvaa. Määritä kunkin viitteen tarkoitus, jotta kohde, tausta ja visuaalinen käsittely eivät sekoitu. GPT Image 2 käsittelee jokaisen kuvasyötteen automaattisesti korkealla lähdeuskollisuudella; input_fidelity tulee jättää pois, koska se ei ole säädettävissä tässä versiossa. Tämä eroaa GPT Image 1:n high- tai low-valinnasta ja GPT Image 1 Minin vain low-tason syöteuskollisuustilasta. Korkean lähdeuskollisuuden syötekäsittely tukee lähtökuvan yksityiskohtia takaamatta jokaisen yksityiskohdan muuttumatonta toistoa.\n\nMaski voi osoittaa muokattavan alueen. Lähtökuvan ja maskin on oltava samassa muodossa ja samoissa mitoissa sekä alle 50 MB oppaan valmisteluvaatimusten mukaan; maski tarvitsee myös alfakanavan. Jos annetaan useita syötekuvia, maski koskee ensimmäistä. Malli käsittelee maskia kehotepohjaisena ohjauksena tiukan geometrisen rajan sijaan. Kuvaile paikallinen muutos ja säilyttämisvaatimukset ja tarkista sitten ympäröivä alue tahattomien erojen varalta.\n\nGPT Image 2 tukee laatutasoja low, medium, high ja auto, ja oletus on auto. 2.5-perheen xhigh- ja max-asetukset eivät kuulu tämän version laatuvalikoimaan. Koko voi olla neliö, vaaka, pysty, automaattinen tai kelvollinen mukautettu leveys ja korkeus. Valmistajan esimerkkeihin kuuluvat 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ja 2160 × 3840 pikseliä. Valitse suunta ja yksityiskohtaisuus todellisen asettelun mukaan sen sijaan, että käsittelisit laatua ja mittoja samana säätönä.\n\nMukautettujen mittojen on oltava kuudentoista pikselin kerrannaisia, pisimmän sivun enintään 3840 pikseliä, pitkän ja lyhyen sivun suhteen enintään 3:1 ja pinta-alan välillä 655 360–8 294 400 pikseliä. Nämä ehdot ovat voimassa samanaikaisesti. Yli 2560 × 1440 -tarkkuudet on merkitty kokeellisiksi. Yhden säännön täyttävä koko voi silti rikkoa toista, joten valitse tuettu mittapari ja kuvaile rajaukselle herkät elementit briiffissä.\n\nTulos on oletuksena PNG, ja myös JPEG tai WebP ovat käytettävissä. JPEG ja WebP tukevat pakkausta väliltä 0–100. Tausta voi olla peittävä tai automaattinen; täsmällinen nykyinen viite kuvaa GPT Image 2:n läpinäkyvyyden ennakkovaiheen ominaisuudeksi. Käytä läpinäkyvyyttä pyytäessäsi PNG- tai WebP-muotoa, jotta alfakanava voidaan säilyttää. Dokumentoitu suoratoistotyönkulku sallii enintään kolme osittaista kuvaa ennen valmista kuvaa; tallenna lopullinen aineisto etenemisen esikatselun sijaan. Valmistajan rajapinta tukee myös eräkäsittelyä.\n\nArvioi tekstin selkeys, esineiden sijainti ja lähtöaineiston yksityiskohtien säilyminen varsinaisesta tuloksesta. GPT Imagella voi olla vaikeuksia täsmällisten tekstien, asettelulle herkkien sommitelmien ja erillisten generointien välillä toistuvan visuaalisen tunnistettavuuden kanssa. Käytä muokkaussarjassa valittua tulosta seuraavana lähtökuvana ja anna konkreettinen näkyvään ongelmaan sidottu muutos. GPT Image 2:n hyödyllinen tulos on selkeään luonti- tai muokkausbriiffiin yhdistetty kuva, jonka korkeauskolliset syötteet, mitat ja laatu valitaan kyseistä tehtävää varten.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a36924f0bdb73f6701abdc296f0e704571f6e43797dc4fd7f57d7ad618286017", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "gpt-image-2GPT Image 2 luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä. Se tukee joustavia kuvakokoja ja käsittelee kuvasyötteet automaattisesti korkealla lähdeuskollisuudella sekä tarjoaa valmiille aineistolle erilliset laatu-, muoto- ja taustasäädöt.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 2 on OpenAI:n malli kuvien luontiin ja muokkaukseen tekstistä ja visuaalisista syötteistä. Se luo uuden kuvan kirjallisesta briiffistä ja voi käyttää lähtökuvia muokkauksiin tai viitteiden ohjaamaan työhön. Käytännön tehtäviä ovat kuvitukset, tuotekonseptit, visuaaliset sommitelmat ja olemassa olevan aineiston muutokset. Se on erillinen versio GPT Image 2.5 Sunburst- ja Flare-malleista, ja sillä on oma laatuvalikoima ja syötteen lähdeuskollisuuden toimintatapa.
Kuvaile luontia varten kohde, näkymä, sommittelu, valo ja tarkoitettu tyyli. Nimeä muokkauksessa, minkä tulee muuttua ja minkä ulkoasun säilyä. Tuotebriiffi voi pyytää keraamista valaisinta vaalealla pinnalla, keskitettyä siluettia ja tilaa kuvatekstille; jatkomuokkaus voi vaihtaa taustan säilyttäen valaisimen muodon ja katselukulman. Dokumentoidut suorat luonti- ja muokkaustyönkulut hyväksyvät enintään 32 000 merkin kehotteet ja voivat palauttaa yhdestä kymmeneen kuvaa.
Viitteisiin perustuva muokkaus hyväksyy enintään kuusitoista syötekuvaa. Määritä kunkin viitteen tarkoitus, jotta kohde, tausta ja visuaalinen käsittely eivät sekoitu. GPT Image 2 käsittelee jokaisen kuvasyötteen automaattisesti korkealla lähdeuskollisuudella; input_fidelity tulee jättää pois, koska se ei ole säädettävissä tässä versiossa. Tämä eroaa GPT Image 1:n high- tai low-valinnasta ja GPT Image 1 Minin vain low-tason syöteuskollisuustilasta. Korkean lähdeuskollisuuden syötekäsittely tukee lähtökuvan yksityiskohtia takaamatta jokaisen yksityiskohdan muuttumatonta toistoa.
Maski voi osoittaa muokattavan alueen. Lähtökuvan ja maskin on oltava samassa muodossa ja samoissa mitoissa sekä alle 50 MB oppaan valmisteluvaatimusten mukaan; maski tarvitsee myös alfakanavan. Jos annetaan useita syötekuvia, maski koskee ensimmäistä. Malli käsittelee maskia kehotepohjaisena ohjauksena tiukan geometrisen rajan sijaan. Kuvaile paikallinen muutos ja säilyttämisvaatimukset ja tarkista sitten ympäröivä alue tahattomien erojen varalta.
GPT Image 2 tukee laatutasoja low, medium, high ja auto, ja oletus on auto. 2.5-perheen xhigh- ja max-asetukset eivät kuulu tämän version laatuvalikoimaan. Koko voi olla neliö, vaaka, pysty, automaattinen tai kelvollinen mukautettu leveys ja korkeus. Valmistajan esimerkkeihin kuuluvat 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ja 2160 × 3840 pikseliä. Valitse suunta ja yksityiskohtaisuus todellisen asettelun mukaan sen sijaan, että käsittelisit laatua ja mittoja samana säätönä.
Mukautettujen mittojen on oltava kuudentoista pikselin kerrannaisia, pisimmän sivun enintään 3840 pikseliä, pitkän ja lyhyen sivun suhteen enintään 3:1 ja pinta-alan välillä 655 360–8 294 400 pikseliä. Nämä ehdot ovat voimassa samanaikaisesti. Yli 2560 × 1440 -tarkkuudet on merkitty kokeellisiksi. Yhden säännön täyttävä koko voi silti rikkoa toista, joten valitse tuettu mittapari ja kuvaile rajaukselle herkät elementit briiffissä.
Tulos on oletuksena PNG, ja myös JPEG tai WebP ovat käytettävissä. JPEG ja WebP tukevat pakkausta väliltä 0–100. Tausta voi olla peittävä tai automaattinen; täsmällinen nykyinen viite kuvaa GPT Image 2:n läpinäkyvyyden ennakkovaiheen ominaisuudeksi. Käytä läpinäkyvyyttä pyytäessäsi PNG- tai WebP-muotoa, jotta alfakanava voidaan säilyttää. Dokumentoitu suoratoistotyönkulku sallii enintään kolme osittaista kuvaa ennen valmista kuvaa; tallenna lopullinen aineisto etenemisen esikatselun sijaan. Valmistajan rajapinta tukee myös eräkäsittelyä.
Arvioi tekstin selkeys, esineiden sijainti ja lähtöaineiston yksityiskohtien säilyminen varsinaisesta tuloksesta. GPT Imagella voi olla vaikeuksia täsmällisten tekstien, asettelulle herkkien sommitelmien ja erillisten generointien välillä toistuvan visuaalisen tunnistettavuuden kanssa. Käytä muokkaussarjassa valittua tulosta seuraavana lähtökuvana ja anna konkreettinen näkyvään ongelmaan sidottu muutos. GPT Image 2:n hyödyllinen tulos on selkeään luonti- tai muokkausbriiffiin yhdistetty kuva, jonka korkeauskolliset syötteet, mitat ja laatu valitaan kyseistä tehtävää varten.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gpt-image-2 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 | Oletus1 |
Kenttäresponse_format | Tyyppistring | VaatimusValinnainen | Arvot & rajat url, b64_json | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttäsize | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäquality | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäbackground | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäoutput_format | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäoutput_compression | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttämoderation | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäinput_fidelity | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttästyle | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäpartial_images | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Tekstistä kuvaksi · Pakollinen: prompt
| Parametri | Sopimus |
|---|---|
Parametrimaterial_types | Sopimustext |
Parametrirequired | Sopimusmodel, prompt |
Parametrioptional_controls | Sopimusnull |
Parametricontent_type | Sopimusapplication/json |
Elinkaari: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Menetelmien rakenteet ja ID:t ovat täsmällisiä; toimittajan kyvykkyys on erillinen pyynnön hyväksymisestä.
POST /v1/images/generationsAiloot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
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");\nLataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Tallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.
Tallenna jokainen data-alkio. Pura jokainen b64_json-arvo tai lataa jokaisen palautetun allekirjoitetun URL-osoitteen sisältö. Valitse tiedostopääte todellisen MIME-tyypin tai tavusisällön perusteella.
Jos kuvan generoinnin tai muokkauksen tulos edellyttää tarkistusta, säilytä alkuperäinen operation_id/X-Client-Request-ID ja palautetut tulostiedot. Hae olemassa olevat omistamasi tulokset mediakirjastosta käyttämällä todellisia task_id- tai asset_id-arvoja. Älä lähetä generointi- tai muokkauspyyntöä uudelleen äläkä muodosta tilakyselyn URL-osoitetta operation_id-arvosta.
| Kenttä | Tyyppi |
|---|---|
Kenttäcreated | Tyyppiinteger |
Kenttädata[].url | Tyyppistring |
Kenttädata[].b64_json | Tyyppibase64 string |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Vastausserver_error | EhtoPalautettu vastaus ilmoittaa, että operaatio tai tulos edellyttää tarkistusta | Seuraava vaiheSäilytä alkuperäinen palautettu operaation tai tehtävän ID, pyynnön otsakkeet ja vastaus; jatka kyseisen alkuperäisen operaation tuettuja lukutoimintoja. Älä lähetä luontipyyntöä uudelleen. |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
gpt-image-2GPT Image 2 luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä. Se tukee joustavia kuvakokoja ja käsittelee kuvasyötteet automaattisesti korkealla lähdeuskollisuudella sekä tarjoaa valmiille aineistolle erilliset laatu-, muoto- ja taustasäädöt.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 2 on OpenAI:n malli kuvien luontiin ja muokkaukseen tekstistä ja visuaalisista syötteistä. Se luo uuden kuvan kirjallisesta briiffistä ja voi käyttää lähtökuvia muokkauksiin tai viitteiden ohjaamaan työhön. Käytännön tehtäviä ovat kuvitukset, tuotekonseptit, visuaaliset sommitelmat ja olemassa olevan aineiston muutokset. Se on erillinen versio GPT Image 2.5 Sunburst- ja Flare-malleista, ja sillä on oma laatuvalikoima ja syötteen lähdeuskollisuuden toimintatapa.
Kuvaile luontia varten kohde, näkymä, sommittelu, valo ja tarkoitettu tyyli. Nimeä muokkauksessa, minkä tulee muuttua ja minkä ulkoasun säilyä. Tuotebriiffi voi pyytää keraamista valaisinta vaalealla pinnalla, keskitettyä siluettia ja tilaa kuvatekstille; jatkomuokkaus voi vaihtaa taustan säilyttäen valaisimen muodon ja katselukulman. Dokumentoidut suorat luonti- ja muokkaustyönkulut hyväksyvät enintään 32 000 merkin kehotteet ja voivat palauttaa yhdestä kymmeneen kuvaa.
Viitteisiin perustuva muokkaus hyväksyy enintään kuusitoista syötekuvaa. Määritä kunkin viitteen tarkoitus, jotta kohde, tausta ja visuaalinen käsittely eivät sekoitu. GPT Image 2 käsittelee jokaisen kuvasyötteen automaattisesti korkealla lähdeuskollisuudella; input_fidelity tulee jättää pois, koska se ei ole säädettävissä tässä versiossa. Tämä eroaa GPT Image 1:n high- tai low-valinnasta ja GPT Image 1 Minin vain low-tason syöteuskollisuustilasta. Korkean lähdeuskollisuuden syötekäsittely tukee lähtökuvan yksityiskohtia takaamatta jokaisen yksityiskohdan muuttumatonta toistoa.
Maski voi osoittaa muokattavan alueen. Lähtökuvan ja maskin on oltava samassa muodossa ja samoissa mitoissa sekä alle 50 MB oppaan valmisteluvaatimusten mukaan; maski tarvitsee myös alfakanavan. Jos annetaan useita syötekuvia, maski koskee ensimmäistä. Malli käsittelee maskia kehotepohjaisena ohjauksena tiukan geometrisen rajan sijaan. Kuvaile paikallinen muutos ja säilyttämisvaatimukset ja tarkista sitten ympäröivä alue tahattomien erojen varalta.
GPT Image 2 tukee laatutasoja low, medium, high ja auto, ja oletus on auto. 2.5-perheen xhigh- ja max-asetukset eivät kuulu tämän version laatuvalikoimaan. Koko voi olla neliö, vaaka, pysty, automaattinen tai kelvollinen mukautettu leveys ja korkeus. Valmistajan esimerkkeihin kuuluvat 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ja 2160 × 3840 pikseliä. Valitse suunta ja yksityiskohtaisuus todellisen asettelun mukaan sen sijaan, että käsittelisit laatua ja mittoja samana säätönä.
Mukautettujen mittojen on oltava kuudentoista pikselin kerrannaisia, pisimmän sivun enintään 3840 pikseliä, pitkän ja lyhyen sivun suhteen enintään 3:1 ja pinta-alan välillä 655 360–8 294 400 pikseliä. Nämä ehdot ovat voimassa samanaikaisesti. Yli 2560 × 1440 -tarkkuudet on merkitty kokeellisiksi. Yhden säännön täyttävä koko voi silti rikkoa toista, joten valitse tuettu mittapari ja kuvaile rajaukselle herkät elementit briiffissä.
Tulos on oletuksena PNG, ja myös JPEG tai WebP ovat käytettävissä. JPEG ja WebP tukevat pakkausta väliltä 0–100. Tausta voi olla peittävä tai automaattinen; täsmällinen nykyinen viite kuvaa GPT Image 2:n läpinäkyvyyden ennakkovaiheen ominaisuudeksi. Käytä läpinäkyvyyttä pyytäessäsi PNG- tai WebP-muotoa, jotta alfakanava voidaan säilyttää. Dokumentoitu suoratoistotyönkulku sallii enintään kolme osittaista kuvaa ennen valmista kuvaa; tallenna lopullinen aineisto etenemisen esikatselun sijaan. Valmistajan rajapinta tukee myös eräkäsittelyä.
Arvioi tekstin selkeys, esineiden sijainti ja lähtöaineiston yksityiskohtien säilyminen varsinaisesta tuloksesta. GPT Imagella voi olla vaikeuksia täsmällisten tekstien, asettelulle herkkien sommitelmien ja erillisten generointien välillä toistuvan visuaalisen tunnistettavuuden kanssa. Käytä muokkaussarjassa valittua tulosta seuraavana lähtökuvana ja anna konkreettinen näkyvään ongelmaan sidottu muutos. GPT Image 2:n hyödyllinen tulos on selkeään luonti- tai muokkausbriiffiin yhdistetty kuva, jonka korkeauskolliset syötteet, mitat ja laatu valitaan kyseistä tehtävää varten.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gpt-image-2 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Enimmäispituus: 32 000 | Oletus— |
Kenttäsize | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: Käytä auto-arvoa tai WIDTHxHEIGHT-muotoa siten, että molemmat mitat ovat jaollisia luvulla 16. Pisin sivu on enintään 3,840 pikseliä ja kokonaiskoko enintään 8,300,000 pikseliä. | Oletusauto |
Kenttäbackground | Tyyppistring | VaatimusValinnainen | Arvot & rajat transparent, opaque, auto | Oletusauto |
Kenttämoderation | Tyyppistring | VaatimusValinnainen | Arvot & rajat low, auto Ehdot: Käytä auto-arvoa tavalliseen sisällön moderointiin. | Oletus— |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 10 | Oletus1 |
Kenttäquality | Tyyppistring | VaatimusValinnainen | Arvot & rajat auto, high, medium, low | Oletusauto |
Kenttäoutput_compression | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 0 Enimmäismäärä: 100 Ehdot: Koskee JPEG- ja WebP-tuloksia; lähetä dokumentoitu kokonaislukuarvo. | Oletus100 |
Kenttäoutput_format | Tyyppistring | VaatimusValinnainen | Arvot & rajat webp, png, jpeg | Oletuspng |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat false Ehdot: Tämä reitti palauttaa yhden valmiin JSON-vastauksen. | Oletusfalse |
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusprompt, model |
Parametrimaterial_types | Sopimustext |
Parametrioptional | Sopimussize, background, moderation, n, quality, output_compression, output_format, stream |
Parametriconditions | SopimusLäpinäkyvä tausta edellyttää PNG- tai WebP-muotoa., Tuloksen pakkaus koskee JPEG- tai WebP-muotoa., Valittu menetelmä luo tuloksen tekstistä. Valmistajan kuvaamat muokkaus- ja suoratoistoasetukset ovat erillisiä ominaisuuksia. |
Elinkaari: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Veloitus |
|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.24576 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
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\nLataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
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.\nTallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.
Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.
Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.
| Kenttä | Tyyppi |
|---|---|
Kenttäcreated | Tyyppi |
Kenttädata[].url | Tyyppi |
Kenttädata[].b64_json | Tyyppi |
Kenttäusage | Tyyppi |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
openai/gpt-image-2GPT Image 2 luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä. Se tukee joustavia kuvakokoja ja käsittelee kuvasyötteet automaattisesti korkealla lähdeuskollisuudella sekä tarjoaa valmiille aineistolle erilliset laatu-, muoto- ja taustasäädöt.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 2 on OpenAI:n malli kuvien luontiin ja muokkaukseen tekstistä ja visuaalisista syötteistä. Se luo uuden kuvan kirjallisesta briiffistä ja voi käyttää lähtökuvia muokkauksiin tai viitteiden ohjaamaan työhön. Käytännön tehtäviä ovat kuvitukset, tuotekonseptit, visuaaliset sommitelmat ja olemassa olevan aineiston muutokset. Se on erillinen versio GPT Image 2.5 Sunburst- ja Flare-malleista, ja sillä on oma laatuvalikoima ja syötteen lähdeuskollisuuden toimintatapa.
Kuvaile luontia varten kohde, näkymä, sommittelu, valo ja tarkoitettu tyyli. Nimeä muokkauksessa, minkä tulee muuttua ja minkä ulkoasun säilyä. Tuotebriiffi voi pyytää keraamista valaisinta vaalealla pinnalla, keskitettyä siluettia ja tilaa kuvatekstille; jatkomuokkaus voi vaihtaa taustan säilyttäen valaisimen muodon ja katselukulman. Dokumentoidut suorat luonti- ja muokkaustyönkulut hyväksyvät enintään 32 000 merkin kehotteet ja voivat palauttaa yhdestä kymmeneen kuvaa.
Viitteisiin perustuva muokkaus hyväksyy enintään kuusitoista syötekuvaa. Määritä kunkin viitteen tarkoitus, jotta kohde, tausta ja visuaalinen käsittely eivät sekoitu. GPT Image 2 käsittelee jokaisen kuvasyötteen automaattisesti korkealla lähdeuskollisuudella; input_fidelity tulee jättää pois, koska se ei ole säädettävissä tässä versiossa. Tämä eroaa GPT Image 1:n high- tai low-valinnasta ja GPT Image 1 Minin vain low-tason syöteuskollisuustilasta. Korkean lähdeuskollisuuden syötekäsittely tukee lähtökuvan yksityiskohtia takaamatta jokaisen yksityiskohdan muuttumatonta toistoa.
Maski voi osoittaa muokattavan alueen. Lähtökuvan ja maskin on oltava samassa muodossa ja samoissa mitoissa sekä alle 50 MB oppaan valmisteluvaatimusten mukaan; maski tarvitsee myös alfakanavan. Jos annetaan useita syötekuvia, maski koskee ensimmäistä. Malli käsittelee maskia kehotepohjaisena ohjauksena tiukan geometrisen rajan sijaan. Kuvaile paikallinen muutos ja säilyttämisvaatimukset ja tarkista sitten ympäröivä alue tahattomien erojen varalta.
GPT Image 2 tukee laatutasoja low, medium, high ja auto, ja oletus on auto. 2.5-perheen xhigh- ja max-asetukset eivät kuulu tämän version laatuvalikoimaan. Koko voi olla neliö, vaaka, pysty, automaattinen tai kelvollinen mukautettu leveys ja korkeus. Valmistajan esimerkkeihin kuuluvat 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 ja 2160 × 3840 pikseliä. Valitse suunta ja yksityiskohtaisuus todellisen asettelun mukaan sen sijaan, että käsittelisit laatua ja mittoja samana säätönä.
Mukautettujen mittojen on oltava kuudentoista pikselin kerrannaisia, pisimmän sivun enintään 3840 pikseliä, pitkän ja lyhyen sivun suhteen enintään 3:1 ja pinta-alan välillä 655 360–8 294 400 pikseliä. Nämä ehdot ovat voimassa samanaikaisesti. Yli 2560 × 1440 -tarkkuudet on merkitty kokeellisiksi. Yhden säännön täyttävä koko voi silti rikkoa toista, joten valitse tuettu mittapari ja kuvaile rajaukselle herkät elementit briiffissä.
Tulos on oletuksena PNG, ja myös JPEG tai WebP ovat käytettävissä. JPEG ja WebP tukevat pakkausta väliltä 0–100. Tausta voi olla peittävä tai automaattinen; täsmällinen nykyinen viite kuvaa GPT Image 2:n läpinäkyvyyden ennakkovaiheen ominaisuudeksi. Käytä läpinäkyvyyttä pyytäessäsi PNG- tai WebP-muotoa, jotta alfakanava voidaan säilyttää. Dokumentoitu suoratoistotyönkulku sallii enintään kolme osittaista kuvaa ennen valmista kuvaa; tallenna lopullinen aineisto etenemisen esikatselun sijaan. Valmistajan rajapinta tukee myös eräkäsittelyä.
Arvioi tekstin selkeys, esineiden sijainti ja lähtöaineiston yksityiskohtien säilyminen varsinaisesta tuloksesta. GPT Imagella voi olla vaikeuksia täsmällisten tekstien, asettelulle herkkien sommitelmien ja erillisten generointien välillä toistuvan visuaalisen tunnistettavuuden kanssa. Käytä muokkaussarjassa valittua tulosta seuraavana lähtökuvana ja anna konkreettinen näkyvään ongelmaan sidottu muutos. GPT Image 2:n hyödyllinen tulos on selkeään luonti- tai muokkausbriiffiin yhdistetty kuva, jonka korkeauskolliset syötteet, mitat ja laatu valitaan kyseistä tehtävää varten.
POST /v1/images/generationstext, imageimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat openai/gpt-image-2 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— |
Kenttäaspect_ratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Oletus— |
Kenttäquality | Tyyppistring | VaatimusValinnainen | Arvot & rajat auto, low, medium, high | Oletus— |
Kenttäbackground | Tyyppistring | VaatimusValinnainen | Arvot & rajat auto, opaque | Oletus— |
Kenttän | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 10 | Oletus— |
Kenttäinput_references | Tyyppiarray | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 16 | Oletus— |
Kenttäoutput_compression | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 0 Enimmäismäärä: 100 | Oletus— |
Kenttäprovider | Tyyppiobject | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt |
Parametrimaterial_types | Sopimustext, image |
Elinkaari: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · todellisuudessa palautettu task_id tai mediakirjaston tietue
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Veloitus |
|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.24576 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
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\nLataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
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.\nTallenna jokainen valmistunut kuva; nouda jokainen palautettu URL tai pura sen Base64-sisältö.
Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.
Säilytä palautettu X-Client-Request-ID täsmäytystä varten. Tee lukukyselyt vain todellisuudessa palautetuilla task_id/asset_id-arvoilla tai käytä omistamaasi mediakirjastoa; älä koskaan rakenna tehtävän URL-osoitetta operaation ID:n perusteella äläkä lähetä luontipyyntöä uudelleen.
| Kenttä | Tyyppi |
|---|---|
Kenttäcreated | Tyyppi |
Kenttädata[].url | Tyyppi |
Kenttädata[].b64_json | Tyyppi |
Kenttäusage | Tyyppi |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images