GPT Image 2.5 Flare on OpenAI:n kuvien luonti- ja muokkausversio, joka on suunnattu nopeaan ja laadukkaaseen arkiseen työhön. Se vastaanottaa tekstiä ja kuvia ja palauttaa kuvatuloksia. Käytä sitä visuaalisiin luonnoksiin, kuvituksiin, tuotekonsepteihin ja toistuviin luoviin tehtäviin, joissa briiffin on muututtava nopeasti käyttökelpoiseksi kuvaksi. Flare eroaa Sunburstista, jonka painopiste on muokkaustarkkuus. Valitse Flare tavanomaiseen kuvanluontiin ja Sunburst, kun tarkka muokkaus on tärkeintä.
Aloita pääkohteesta, toiminnasta, ympäristöstä, sommittelusta ja visuaalisesta käsittelystä. Pyydä kampanjakuvitukseksi pyöräilijä ylittämässä pientä siltaa lämpimässä iltavalossa, vahva siluetti ja avointa taivasta myöhemmin lisättävälle tekstille. Tiivis luonnostelubriiffi voi jättää esteettiset päätökset avoimiksi; tuotantobriiffin tulee nimetä tärkeät yksityiskohdat ja sijoittelu. Suorat luonti- ja muokkaustyönkulut sallivat enintään 32 000 merkin kehotteet ja yhdestä kymmeneen tulosta, joten muutaman variaation vertailu samaan tarkoitukseen on hyödyllistä.
Muokkauksessa voi antaa enintään kuusitoista viitekuvaa. Määritä kullekin viitteelle selkeä rooli sen sijaan, että odottaisit mallin päättävän, edustaako kuva kohteen tunnistettavuutta, maisemaa vai tyyliä. Maski voi ohjata alueen muutosta; usean kuvan yhteydessä se koskee ensimmäistä. Kuvan ja maskin muodon ja mittojen on vastattava toisiaan, ja maskissa on oltava alfakanava. Opas vaatii, että lähtökuva ja maski ovat alle 50 MB. Maski on ohjauskeino eikä lupaus rajojen täsmällisestä säilymisestä, joten kerro sekä haluttu muutos että se, minkä tulee pysyä tunnistettavana.
Flaren laatuasetukset ovat low, medium, high, xhigh, max ja auto, ja oletus on auto. Matalampi laatu voi palvella nopeaa visuaalista luonnosta; korkeampia asetuksia voi verrata lopullisen aineiston yksityiskohtia varten. Laatu on riippumaton koosta ja tulosteen pakkauksesta. Vakiokokoja ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536; myös automaattiset tai mukautetut mitat ovat käytettävissä. Valitse suunta lopullisen sijoittelun ja näkymän käyttökelpoisen tilan mukaan.
Mukautetun leveyden ja korkeuden on oltava kuudentoista kerrannaisia, eikä kumpikaan sivu saa ylittää 3840 pikseliä. Sallittu suhde on 1:3–3:1, ja kokonaispinta-alan on oltava vähintään 655 360 ja enintään 8 294 400 pikseliä. Kaikki neljä ehtoa ovat voimassa yhtä aikaa. Opas määrittää yli 2560 × 1440 -tarkkuudet kokeellisiksi. Käytä kelvollista sommitteluun sopivaa kuvakokoa ja sisällytä rajaukselle herkät yksityiskohdat briiffiin sen sijaan, että pitäisit suurempaa tarkkuutta automaattisena asettelun parannuksena.
Tulosmuoto on oletuksena PNG, ja vaihtoehtoja ovat JPEG ja WebP. JPEG ja WebP sallivat pakkauksen väliltä 0–100. Valitse läpinäkyvää taustaa varten PNG tai WebP; myös peittävät ja automaattiset taustat ovat tuettuja. Läpinäkyvän aineiston voi sijoittaa myöhempään asetteluun, kun taas peittävä kuva sisältää oman taustansa. Valitse muoto, tausta ja pakkaus todellisen toimitustarpeen mukaan ja säilytä valmistunut tiedosto briiffin ja valittujen asetusten kanssa.
Valmistaja dokumentoi suoran kuvanluonnin ja muokkaukset sekä keskustelullisen kuvatyökalun, joka voi säilyttää valittuja tuloksia jatkomuutoksia varten. Tässä työnkulussa toiminto voi olla automaattinen, pakotettu luonti tai pakotettu muokkaus, kun kontekstissa on kuva. Suoratoisto voi näyttää enintään kolme osittaista kuvaa ennen lopputulosta. Nämä esikatselut osoittavat etenemistä eivätkä ole uusia valmiita toimituksia. Jatka iteratiivisessa työssä valitusta kuvasta ja kuvaile näkyvä muutos, kuten yhden esineen siirtäminen tai värikäsittelyn säätö. Valmistajan rajapinta tukee myös eräkäsittelyä.
Tarkista kuvan tekstit, esineiden sijoittelu, kohteen yksityiskohdat ja sommittelu tarkoitetussa koossa. GPT Imagella voi edelleen olla vaikeuksia tekstin täsmällisen sijoittelun, rakenteisten asettelujen ja toistuvan visuaalisen tunnistettavuuden kanssa eri generointien välillä. Säilytä hyväksytty variaatio seuraavana viitteenä ja rajaa seuraava muokkaus tärkeään ongelmaan. Flaren arkisen kuvanluonnin rooli on hyödyllinen selkeässä briiffin, kuvavaihtoehtojen, valinnan ja viimeistelyn sarjassa, jossa lopullista aineistoa arvioidaan todellista luovaa tarkoitusta vasten.
", "aboutText": "GPT Image 2.5 Flare on OpenAI:n kuvien luonti- ja muokkausversio, joka on suunnattu nopeaan ja laadukkaaseen arkiseen työhön. Se vastaanottaa tekstiä ja kuvia ja palauttaa kuvatuloksia. Käytä sitä visuaalisiin luonnoksiin, kuvituksiin, tuotekonsepteihin ja toistuviin luoviin tehtäviin, joissa briiffin on muututtava nopeasti käyttökelpoiseksi kuvaksi. Flare eroaa Sunburstista, jonka painopiste on muokkaustarkkuus. Valitse Flare tavanomaiseen kuvanluontiin ja Sunburst, kun tarkka muokkaus on tärkeintä.\n\nAloita pääkohteesta, toiminnasta, ympäristöstä, sommittelusta ja visuaalisesta käsittelystä. Pyydä kampanjakuvitukseksi pyöräilijä ylittämässä pientä siltaa lämpimässä iltavalossa, vahva siluetti ja avointa taivasta myöhemmin lisättävälle tekstille. Tiivis luonnostelubriiffi voi jättää esteettiset päätökset avoimiksi; tuotantobriiffin tulee nimetä tärkeät yksityiskohdat ja sijoittelu. Suorat luonti- ja muokkaustyönkulut sallivat enintään 32 000 merkin kehotteet ja yhdestä kymmeneen tulosta, joten muutaman variaation vertailu samaan tarkoitukseen on hyödyllistä.\n\nMuokkauksessa voi antaa enintään kuusitoista viitekuvaa. Määritä kullekin viitteelle selkeä rooli sen sijaan, että odottaisit mallin päättävän, edustaako kuva kohteen tunnistettavuutta, maisemaa vai tyyliä. Maski voi ohjata alueen muutosta; usean kuvan yhteydessä se koskee ensimmäistä. Kuvan ja maskin muodon ja mittojen on vastattava toisiaan, ja maskissa on oltava alfakanava. Opas vaatii, että lähtökuva ja maski ovat alle 50 MB. Maski on ohjauskeino eikä lupaus rajojen täsmällisestä säilymisestä, joten kerro sekä haluttu muutos että se, minkä tulee pysyä tunnistettavana.\n\nFlaren laatuasetukset ovat low, medium, high, xhigh, max ja auto, ja oletus on auto. Matalampi laatu voi palvella nopeaa visuaalista luonnosta; korkeampia asetuksia voi verrata lopullisen aineiston yksityiskohtia varten. Laatu on riippumaton koosta ja tulosteen pakkauksesta. Vakiokokoja ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536; myös automaattiset tai mukautetut mitat ovat käytettävissä. Valitse suunta lopullisen sijoittelun ja näkymän käyttökelpoisen tilan mukaan.\n\nMukautetun leveyden ja korkeuden on oltava kuudentoista kerrannaisia, eikä kumpikaan sivu saa ylittää 3840 pikseliä. Sallittu suhde on 1:3–3:1, ja kokonaispinta-alan on oltava vähintään 655 360 ja enintään 8 294 400 pikseliä. Kaikki neljä ehtoa ovat voimassa yhtä aikaa. Opas määrittää yli 2560 × 1440 -tarkkuudet kokeellisiksi. Käytä kelvollista sommitteluun sopivaa kuvakokoa ja sisällytä rajaukselle herkät yksityiskohdat briiffiin sen sijaan, että pitäisit suurempaa tarkkuutta automaattisena asettelun parannuksena.\n\nTulosmuoto on oletuksena PNG, ja vaihtoehtoja ovat JPEG ja WebP. JPEG ja WebP sallivat pakkauksen väliltä 0–100. Valitse läpinäkyvää taustaa varten PNG tai WebP; myös peittävät ja automaattiset taustat ovat tuettuja. Läpinäkyvän aineiston voi sijoittaa myöhempään asetteluun, kun taas peittävä kuva sisältää oman taustansa. Valitse muoto, tausta ja pakkaus todellisen toimitustarpeen mukaan ja säilytä valmistunut tiedosto briiffin ja valittujen asetusten kanssa.\n\nValmistaja dokumentoi suoran kuvanluonnin ja muokkaukset sekä keskustelullisen kuvatyökalun, joka voi säilyttää valittuja tuloksia jatkomuutoksia varten. Tässä työnkulussa toiminto voi olla automaattinen, pakotettu luonti tai pakotettu muokkaus, kun kontekstissa on kuva. Suoratoisto voi näyttää enintään kolme osittaista kuvaa ennen lopputulosta. Nämä esikatselut osoittavat etenemistä eivätkä ole uusia valmiita toimituksia. Jatka iteratiivisessa työssä valitusta kuvasta ja kuvaile näkyvä muutos, kuten yhden esineen siirtäminen tai värikäsittelyn säätö. Valmistajan rajapinta tukee myös eräkäsittelyä.\n\nTarkista kuvan tekstit, esineiden sijoittelu, kohteen yksityiskohdat ja sommittelu tarkoitetussa koossa. GPT Imagella voi edelleen olla vaikeuksia tekstin täsmällisen sijoittelun, rakenteisten asettelujen ja toistuvan visuaalisen tunnistettavuuden kanssa eri generointien välillä. Säilytä hyväksytty variaatio seuraavana viitteenä ja rajaa seuraava muokkaus tärkeään ongelmaan. Flaren arkisen kuvanluonnin rooli on hyödyllinen selkeässä briiffin, kuvavaihtoehtojen, valinnan ja viimeistelyn sarjassa, jossa lopullista aineistoa arvioidaan todellista luovaa tarkoitusta vasten.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0cba8c45be53173fe938f2655023f5928a4037a336fb4fad574e93bff3cecbc5", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "gpt-image-2.5-flareGPT Image 2.5 Flare luo ja muokkaa kuvia tekstistä ja viitteistä painottaen nopeaa arkista visuaalista tuotantoa. Se tukee mukautettuja kokoja, läpinäkyviä taustoja, maskeja ja max-tasoon ulottuvia laatuasetuksia luonnoksia, kuvituksia ja kampanja-aineistoja varten.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 2.5 Flare on OpenAI:n kuvien luonti- ja muokkausversio, joka on suunnattu nopeaan ja laadukkaaseen arkiseen työhön. Se vastaanottaa tekstiä ja kuvia ja palauttaa kuvatuloksia. Käytä sitä visuaalisiin luonnoksiin, kuvituksiin, tuotekonsepteihin ja toistuviin luoviin tehtäviin, joissa briiffin on muututtava nopeasti käyttökelpoiseksi kuvaksi. Flare eroaa Sunburstista, jonka painopiste on muokkaustarkkuus. Valitse Flare tavanomaiseen kuvanluontiin ja Sunburst, kun tarkka muokkaus on tärkeintä.
Aloita pääkohteesta, toiminnasta, ympäristöstä, sommittelusta ja visuaalisesta käsittelystä. Pyydä kampanjakuvitukseksi pyöräilijä ylittämässä pientä siltaa lämpimässä iltavalossa, vahva siluetti ja avointa taivasta myöhemmin lisättävälle tekstille. Tiivis luonnostelubriiffi voi jättää esteettiset päätökset avoimiksi; tuotantobriiffin tulee nimetä tärkeät yksityiskohdat ja sijoittelu. Suorat luonti- ja muokkaustyönkulut sallivat enintään 32 000 merkin kehotteet ja yhdestä kymmeneen tulosta, joten muutaman variaation vertailu samaan tarkoitukseen on hyödyllistä.
Muokkauksessa voi antaa enintään kuusitoista viitekuvaa. Määritä kullekin viitteelle selkeä rooli sen sijaan, että odottaisit mallin päättävän, edustaako kuva kohteen tunnistettavuutta, maisemaa vai tyyliä. Maski voi ohjata alueen muutosta; usean kuvan yhteydessä se koskee ensimmäistä. Kuvan ja maskin muodon ja mittojen on vastattava toisiaan, ja maskissa on oltava alfakanava. Opas vaatii, että lähtökuva ja maski ovat alle 50 MB. Maski on ohjauskeino eikä lupaus rajojen täsmällisestä säilymisestä, joten kerro sekä haluttu muutos että se, minkä tulee pysyä tunnistettavana.
Flaren laatuasetukset ovat low, medium, high, xhigh, max ja auto, ja oletus on auto. Matalampi laatu voi palvella nopeaa visuaalista luonnosta; korkeampia asetuksia voi verrata lopullisen aineiston yksityiskohtia varten. Laatu on riippumaton koosta ja tulosteen pakkauksesta. Vakiokokoja ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536; myös automaattiset tai mukautetut mitat ovat käytettävissä. Valitse suunta lopullisen sijoittelun ja näkymän käyttökelpoisen tilan mukaan.
Mukautetun leveyden ja korkeuden on oltava kuudentoista kerrannaisia, eikä kumpikaan sivu saa ylittää 3840 pikseliä. Sallittu suhde on 1:3–3:1, ja kokonaispinta-alan on oltava vähintään 655 360 ja enintään 8 294 400 pikseliä. Kaikki neljä ehtoa ovat voimassa yhtä aikaa. Opas määrittää yli 2560 × 1440 -tarkkuudet kokeellisiksi. Käytä kelvollista sommitteluun sopivaa kuvakokoa ja sisällytä rajaukselle herkät yksityiskohdat briiffiin sen sijaan, että pitäisit suurempaa tarkkuutta automaattisena asettelun parannuksena.
Tulosmuoto on oletuksena PNG, ja vaihtoehtoja ovat JPEG ja WebP. JPEG ja WebP sallivat pakkauksen väliltä 0–100. Valitse läpinäkyvää taustaa varten PNG tai WebP; myös peittävät ja automaattiset taustat ovat tuettuja. Läpinäkyvän aineiston voi sijoittaa myöhempään asetteluun, kun taas peittävä kuva sisältää oman taustansa. Valitse muoto, tausta ja pakkaus todellisen toimitustarpeen mukaan ja säilytä valmistunut tiedosto briiffin ja valittujen asetusten kanssa.
Valmistaja dokumentoi suoran kuvanluonnin ja muokkaukset sekä keskustelullisen kuvatyökalun, joka voi säilyttää valittuja tuloksia jatkomuutoksia varten. Tässä työnkulussa toiminto voi olla automaattinen, pakotettu luonti tai pakotettu muokkaus, kun kontekstissa on kuva. Suoratoisto voi näyttää enintään kolme osittaista kuvaa ennen lopputulosta. Nämä esikatselut osoittavat etenemistä eivätkä ole uusia valmiita toimituksia. Jatka iteratiivisessa työssä valitusta kuvasta ja kuvaile näkyvä muutos, kuten yhden esineen siirtäminen tai värikäsittelyn säätö. Valmistajan rajapinta tukee myös eräkäsittelyä.
Tarkista kuvan tekstit, esineiden sijoittelu, kohteen yksityiskohdat ja sommittelu tarkoitetussa koossa. GPT Imagella voi edelleen olla vaikeuksia tekstin täsmällisen sijoittelun, rakenteisten asettelujen ja toistuvan visuaalisen tunnistettavuuden kanssa eri generointien välillä. Säilytä hyväksytty variaatio seuraavana viitteenä ja rajaa seuraava muokkaus tärkeään ongelmaan. Flaren arkisen kuvanluonnin rooli on hyödyllinen selkeässä briiffin, kuvavaihtoehtojen, valinnan ja viimeistelyn sarjassa, jossa lopullista aineistoa arvioidaan todellista luovaa tarkoitusta vasten.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gpt-image-2.5-flare | 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.5-flare", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-flare", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
gpt-image-2.5-flareGPT Image 2.5 Flare luo ja muokkaa kuvia tekstistä ja viitteistä painottaen nopeaa arkista visuaalista tuotantoa. Se tukee mukautettuja kokoja, läpinäkyviä taustoja, maskeja ja max-tasoon ulottuvia laatuasetuksia luonnoksia, kuvituksia ja kampanja-aineistoja varten.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 2.5 Flare on OpenAI:n kuvien luonti- ja muokkausversio, joka on suunnattu nopeaan ja laadukkaaseen arkiseen työhön. Se vastaanottaa tekstiä ja kuvia ja palauttaa kuvatuloksia. Käytä sitä visuaalisiin luonnoksiin, kuvituksiin, tuotekonsepteihin ja toistuviin luoviin tehtäviin, joissa briiffin on muututtava nopeasti käyttökelpoiseksi kuvaksi. Flare eroaa Sunburstista, jonka painopiste on muokkaustarkkuus. Valitse Flare tavanomaiseen kuvanluontiin ja Sunburst, kun tarkka muokkaus on tärkeintä.
Aloita pääkohteesta, toiminnasta, ympäristöstä, sommittelusta ja visuaalisesta käsittelystä. Pyydä kampanjakuvitukseksi pyöräilijä ylittämässä pientä siltaa lämpimässä iltavalossa, vahva siluetti ja avointa taivasta myöhemmin lisättävälle tekstille. Tiivis luonnostelubriiffi voi jättää esteettiset päätökset avoimiksi; tuotantobriiffin tulee nimetä tärkeät yksityiskohdat ja sijoittelu. Suorat luonti- ja muokkaustyönkulut sallivat enintään 32 000 merkin kehotteet ja yhdestä kymmeneen tulosta, joten muutaman variaation vertailu samaan tarkoitukseen on hyödyllistä.
Muokkauksessa voi antaa enintään kuusitoista viitekuvaa. Määritä kullekin viitteelle selkeä rooli sen sijaan, että odottaisit mallin päättävän, edustaako kuva kohteen tunnistettavuutta, maisemaa vai tyyliä. Maski voi ohjata alueen muutosta; usean kuvan yhteydessä se koskee ensimmäistä. Kuvan ja maskin muodon ja mittojen on vastattava toisiaan, ja maskissa on oltava alfakanava. Opas vaatii, että lähtökuva ja maski ovat alle 50 MB. Maski on ohjauskeino eikä lupaus rajojen täsmällisestä säilymisestä, joten kerro sekä haluttu muutos että se, minkä tulee pysyä tunnistettavana.
Flaren laatuasetukset ovat low, medium, high, xhigh, max ja auto, ja oletus on auto. Matalampi laatu voi palvella nopeaa visuaalista luonnosta; korkeampia asetuksia voi verrata lopullisen aineiston yksityiskohtia varten. Laatu on riippumaton koosta ja tulosteen pakkauksesta. Vakiokokoja ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536; myös automaattiset tai mukautetut mitat ovat käytettävissä. Valitse suunta lopullisen sijoittelun ja näkymän käyttökelpoisen tilan mukaan.
Mukautetun leveyden ja korkeuden on oltava kuudentoista kerrannaisia, eikä kumpikaan sivu saa ylittää 3840 pikseliä. Sallittu suhde on 1:3–3:1, ja kokonaispinta-alan on oltava vähintään 655 360 ja enintään 8 294 400 pikseliä. Kaikki neljä ehtoa ovat voimassa yhtä aikaa. Opas määrittää yli 2560 × 1440 -tarkkuudet kokeellisiksi. Käytä kelvollista sommitteluun sopivaa kuvakokoa ja sisällytä rajaukselle herkät yksityiskohdat briiffiin sen sijaan, että pitäisit suurempaa tarkkuutta automaattisena asettelun parannuksena.
Tulosmuoto on oletuksena PNG, ja vaihtoehtoja ovat JPEG ja WebP. JPEG ja WebP sallivat pakkauksen väliltä 0–100. Valitse läpinäkyvää taustaa varten PNG tai WebP; myös peittävät ja automaattiset taustat ovat tuettuja. Läpinäkyvän aineiston voi sijoittaa myöhempään asetteluun, kun taas peittävä kuva sisältää oman taustansa. Valitse muoto, tausta ja pakkaus todellisen toimitustarpeen mukaan ja säilytä valmistunut tiedosto briiffin ja valittujen asetusten kanssa.
Valmistaja dokumentoi suoran kuvanluonnin ja muokkaukset sekä keskustelullisen kuvatyökalun, joka voi säilyttää valittuja tuloksia jatkomuutoksia varten. Tässä työnkulussa toiminto voi olla automaattinen, pakotettu luonti tai pakotettu muokkaus, kun kontekstissa on kuva. Suoratoisto voi näyttää enintään kolme osittaista kuvaa ennen lopputulosta. Nämä esikatselut osoittavat etenemistä eivätkä ole uusia valmiita toimituksia. Jatka iteratiivisessa työssä valitusta kuvasta ja kuvaile näkyvä muutos, kuten yhden esineen siirtäminen tai värikäsittelyn säätö. Valmistajan rajapinta tukee myös eräkäsittelyä.
Tarkista kuvan tekstit, esineiden sijoittelu, kohteen yksityiskohdat ja sommittelu tarkoitetussa koossa. GPT Imagella voi edelleen olla vaikeuksia tekstin täsmällisen sijoittelun, rakenteisten asettelujen ja toistuvan visuaalisen tunnistettavuuden kanssa eri generointien välillä. Säilytä hyväksytty variaatio seuraavana viitteenä ja rajaa seuraava muokkaus tärkeään ongelmaan. Flaren arkisen kuvanluonnin rooli on hyödyllinen selkeässä briiffin, kuvavaihtoehtojen, valinnan ja viimeistelyn sarjassa, jossa lopullista aineistoa arvioidaan todellista luovaa tarkoitusta vasten.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gpt-image-2.5-flare | 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.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\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.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
openai/gpt-image-2.5-flareGPT Image 2.5 Flare luo ja muokkaa kuvia tekstistä ja viitteistä painottaen nopeaa arkista visuaalista tuotantoa. Se tukee mukautettuja kokoja, läpinäkyviä taustoja, maskeja ja max-tasoon ulottuvia laatuasetuksia luonnoksia, kuvituksia ja kampanja-aineistoja varten.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 2.5 Flare on OpenAI:n kuvien luonti- ja muokkausversio, joka on suunnattu nopeaan ja laadukkaaseen arkiseen työhön. Se vastaanottaa tekstiä ja kuvia ja palauttaa kuvatuloksia. Käytä sitä visuaalisiin luonnoksiin, kuvituksiin, tuotekonsepteihin ja toistuviin luoviin tehtäviin, joissa briiffin on muututtava nopeasti käyttökelpoiseksi kuvaksi. Flare eroaa Sunburstista, jonka painopiste on muokkaustarkkuus. Valitse Flare tavanomaiseen kuvanluontiin ja Sunburst, kun tarkka muokkaus on tärkeintä.
Aloita pääkohteesta, toiminnasta, ympäristöstä, sommittelusta ja visuaalisesta käsittelystä. Pyydä kampanjakuvitukseksi pyöräilijä ylittämässä pientä siltaa lämpimässä iltavalossa, vahva siluetti ja avointa taivasta myöhemmin lisättävälle tekstille. Tiivis luonnostelubriiffi voi jättää esteettiset päätökset avoimiksi; tuotantobriiffin tulee nimetä tärkeät yksityiskohdat ja sijoittelu. Suorat luonti- ja muokkaustyönkulut sallivat enintään 32 000 merkin kehotteet ja yhdestä kymmeneen tulosta, joten muutaman variaation vertailu samaan tarkoitukseen on hyödyllistä.
Muokkauksessa voi antaa enintään kuusitoista viitekuvaa. Määritä kullekin viitteelle selkeä rooli sen sijaan, että odottaisit mallin päättävän, edustaako kuva kohteen tunnistettavuutta, maisemaa vai tyyliä. Maski voi ohjata alueen muutosta; usean kuvan yhteydessä se koskee ensimmäistä. Kuvan ja maskin muodon ja mittojen on vastattava toisiaan, ja maskissa on oltava alfakanava. Opas vaatii, että lähtökuva ja maski ovat alle 50 MB. Maski on ohjauskeino eikä lupaus rajojen täsmällisestä säilymisestä, joten kerro sekä haluttu muutos että se, minkä tulee pysyä tunnistettavana.
Flaren laatuasetukset ovat low, medium, high, xhigh, max ja auto, ja oletus on auto. Matalampi laatu voi palvella nopeaa visuaalista luonnosta; korkeampia asetuksia voi verrata lopullisen aineiston yksityiskohtia varten. Laatu on riippumaton koosta ja tulosteen pakkauksesta. Vakiokokoja ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536; myös automaattiset tai mukautetut mitat ovat käytettävissä. Valitse suunta lopullisen sijoittelun ja näkymän käyttökelpoisen tilan mukaan.
Mukautetun leveyden ja korkeuden on oltava kuudentoista kerrannaisia, eikä kumpikaan sivu saa ylittää 3840 pikseliä. Sallittu suhde on 1:3–3:1, ja kokonaispinta-alan on oltava vähintään 655 360 ja enintään 8 294 400 pikseliä. Kaikki neljä ehtoa ovat voimassa yhtä aikaa. Opas määrittää yli 2560 × 1440 -tarkkuudet kokeellisiksi. Käytä kelvollista sommitteluun sopivaa kuvakokoa ja sisällytä rajaukselle herkät yksityiskohdat briiffiin sen sijaan, että pitäisit suurempaa tarkkuutta automaattisena asettelun parannuksena.
Tulosmuoto on oletuksena PNG, ja vaihtoehtoja ovat JPEG ja WebP. JPEG ja WebP sallivat pakkauksen väliltä 0–100. Valitse läpinäkyvää taustaa varten PNG tai WebP; myös peittävät ja automaattiset taustat ovat tuettuja. Läpinäkyvän aineiston voi sijoittaa myöhempään asetteluun, kun taas peittävä kuva sisältää oman taustansa. Valitse muoto, tausta ja pakkaus todellisen toimitustarpeen mukaan ja säilytä valmistunut tiedosto briiffin ja valittujen asetusten kanssa.
Valmistaja dokumentoi suoran kuvanluonnin ja muokkaukset sekä keskustelullisen kuvatyökalun, joka voi säilyttää valittuja tuloksia jatkomuutoksia varten. Tässä työnkulussa toiminto voi olla automaattinen, pakotettu luonti tai pakotettu muokkaus, kun kontekstissa on kuva. Suoratoisto voi näyttää enintään kolme osittaista kuvaa ennen lopputulosta. Nämä esikatselut osoittavat etenemistä eivätkä ole uusia valmiita toimituksia. Jatka iteratiivisessa työssä valitusta kuvasta ja kuvaile näkyvä muutos, kuten yhden esineen siirtäminen tai värikäsittelyn säätö. Valmistajan rajapinta tukee myös eräkäsittelyä.
Tarkista kuvan tekstit, esineiden sijoittelu, kohteen yksityiskohdat ja sommittelu tarkoitetussa koossa. GPT Imagella voi edelleen olla vaikeuksia tekstin täsmällisen sijoittelun, rakenteisten asettelujen ja toistuvan visuaalisen tunnistettavuuden kanssa eri generointien välillä. Säilytä hyväksytty variaatio seuraavana viitteenä ja rajaa seuraava muokkaus tärkeään ongelmaan. Flaren arkisen kuvanluonnin rooli on hyödyllinen selkeässä briiffin, kuvavaihtoehtojen, valinnan ja viimeistelyn sarjassa, jossa lopullista aineistoa arvioidaan todellista luovaa tarkoitusta vasten.
POST /v1/images/generationstext, imageimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat openai/gpt-image-2.5-flare | 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, xhigh, max | Oletus— |
Kenttäbackground | Tyyppistring | VaatimusValinnainen | Arvot & rajat auto, transparent, 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.5-flare', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\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.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare