GPT Image 1.5 on OpenAI:n malli kuvien luomiseen tekstikuvauksen perusteella. Valmistaja painottaa ohjeiden noudattamista ja yksityiskohtaisen tehtävän käsittelyä: siinä voidaan määrittää näkymän sisältö, sommittelu, kohteiden ulkonäkö ja haluttu tyyli. Kuvamenetelmän tulos on valmis kuva.
Ailootissa tämä kortti koskee generointia tekstisyötteestä. OpenAI kuvaa myös mallin lähtökuvien käsittelyn, muokkauksen ja yksittäisten alueiden muuttamisen. Nämä kyvyt vaativat erillisen kuvasyötteen tuen eivätkä kuulu tässä nimettyyn tekstipohjaiseen generointitapaan.
OpenAI:n erikseen tarjoamassa muokkaustoiminnossa maski toimii ohjenuorana: tuloksen tarkkaa vastaavuutta sen ääriviivoihin ei taata. Toiminto tarvitsee lähtökuvan lähettämisen tuen; nykyinen Ailoot-kortti koskee edelleen generointia tekstisyötteestä.
Tarjolla ovat neliökoko 1024x1024, vaakakoko 1536x1024 ja pystykoko 1024x1536 sekä automaattinen valinta. Muiden mallien vapaasti valittavia kokoja ei tule siirtää tähän versioon.
Laatutasot ovat low, medium, high ja auto. Laatuvalinta vaikuttaa käsittelyn määrään ja tuloksen yksityiskohtaisuuteen. Laatu ja koko ovat eri asetuksia: kuvan suunta määrittää sommittelutilan ja laatutaso sen muodostamistavan. Tasoja xhigh ja max ei ilmoiteta GPT Image 1.5:lle.
Tulos luodaan oletuksena PNG-muodossa; myös JPEG ja WebP ovat tarjolla. JPEG- ja WebP-muodoissa voidaan määrittää pakkausaste. Tämä on tulostiedoston asetus, joka eroaa generoinnin laadusta.
Valmistaja mahdollistaa läpinäkyvän ja peittävän taustan sekä automaattisen valinnan. Läpinäkyvyys vaatii PNG- tai WebP-muodon: JPEG ei säilytä alfakanavaa. Läpinäkyvä tausta on hyödyllinen, kun kuvaa käytetään erillisenä kohteena myöhemmässä sommitelmassa. Yksittäisten parametrien tuki on suhteutettava valittuun menetelmään.
Malli voi sisällyttää kuvaan tekstejä ja koota näkymän useista elementeistä, mutta tekstin ja kohteiden tarkkaa sijoittelua ei taata. Myös hahmon ulkonäön tai visuaalisen toteutuksen toistettavuutta erillisten generointien välillä on valvottava.
Vaativan kuvan muodostaminen voi kestää yksinkertaista pidempään; OpenAI:n mukaan yksittäiset vaativat tehtävät voivat kestää enintään kaksi minuuttia. Tulokseen vaikuttavat lähtökuvauksen täydellisyys ja valmiin kuvan tarkistus: tekstien luettavuus, yksityiskohtien sijainti ja vastaavuus annettuun näkymään arvioidaan itse tiedostosta.
", "aboutText": "### Kuva yksityiskohtaisen tehtävänannon perusteella\n\nGPT Image 1.5 on OpenAI:n malli kuvien luomiseen tekstikuvauksen perusteella. Valmistaja painottaa ohjeiden noudattamista ja yksityiskohtaisen tehtävän käsittelyä: siinä voidaan määrittää näkymän sisältö, sommittelu, kohteiden ulkonäkö ja haluttu tyyli. Kuvamenetelmän tulos on valmis kuva.\n\nAilootissa tämä kortti koskee generointia tekstisyötteestä. OpenAI kuvaa myös mallin lähtökuvien käsittelyn, muokkauksen ja yksittäisten alueiden muuttamisen. Nämä kyvyt vaativat erillisen kuvasyötteen tuen eivätkä kuulu tässä nimettyyn tekstipohjaiseen generointitapaan.\n\nOpenAI:n erikseen tarjoamassa muokkaustoiminnossa maski toimii ohjenuorana: tuloksen tarkkaa vastaavuutta sen ääriviivoihin ei taata. Toiminto tarvitsee lähtökuvan lähettämisen tuen; nykyinen Ailoot-kortti koskee edelleen generointia tekstisyötteestä.\n\n### Kolme kuvamuotoa ja laadun säätö\n\nTarjolla ovat neliökoko `1024x1024`, vaakakoko `1536x1024` ja pystykoko `1024x1536` sekä automaattinen valinta. Muiden mallien vapaasti valittavia kokoja ei tule siirtää tähän versioon.\n\nLaatutasot ovat `low`, `medium`, `high` ja `auto`. Laatuvalinta vaikuttaa käsittelyn määrään ja tuloksen yksityiskohtaisuuteen. Laatu ja koko ovat eri asetuksia: kuvan suunta määrittää sommittelutilan ja laatutaso sen muodostamistavan. Tasoja `xhigh` ja `max` ei ilmoiteta GPT Image 1.5:lle.\n\n### Tiedostomuoto ja tausta\n\nTulos luodaan oletuksena PNG-muodossa; myös JPEG ja WebP ovat tarjolla. JPEG- ja WebP-muodoissa voidaan määrittää pakkausaste. Tämä on tulostiedoston asetus, joka eroaa generoinnin laadusta.\n\nValmistaja mahdollistaa läpinäkyvän ja peittävän taustan sekä automaattisen valinnan. Läpinäkyvyys vaatii PNG- tai WebP-muodon: JPEG ei säilytä alfakanavaa. Läpinäkyvä tausta on hyödyllinen, kun kuvaa käytetään erillisenä kohteena myöhemmässä sommitelmassa. Yksittäisten parametrien tuki on suhteutettava valittuun menetelmään.\n\n### Teksti ja sommittelu vaativat tarkistusta\n\nMalli voi sisällyttää kuvaan tekstejä ja koota näkymän useista elementeistä, mutta tekstin ja kohteiden tarkkaa sijoittelua ei taata. Myös hahmon ulkonäön tai visuaalisen toteutuksen toistettavuutta erillisten generointien välillä on valvottava.\n\nVaativan kuvan muodostaminen voi kestää yksinkertaista pidempään; OpenAI:n mukaan yksittäiset vaativat tehtävät voivat kestää enintään kaksi minuuttia. Tulokseen vaikuttavat lähtökuvauksen täydellisyys ja valmiin kuvan tarkistus: tekstien luettavuus, yksityiskohtien sijainti ja vastaavuus annettuun näkymään arvioidaan itse tiedostosta.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "99007a6d39ad2af4f26d7fbdf8030a5861bd6ab54c7763dee5c32e98c8a3f25b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "gpt-image-1.5GPT Image 1.5 luo kuvia tekstitehtävän perusteella painottaen yksityiskohtaisten ohjeiden noudattamista. Tarjolla on kolme kuvamuotoa sekä useita laatutasoja ja tulosformaatteja.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 1.5 on OpenAI:n malli kuvien luomiseen tekstikuvauksen perusteella. Valmistaja painottaa ohjeiden noudattamista ja yksityiskohtaisen tehtävän käsittelyä: siinä voidaan määrittää näkymän sisältö, sommittelu, kohteiden ulkonäkö ja haluttu tyyli. Kuvamenetelmän tulos on valmis kuva.
Ailootissa tämä kortti koskee generointia tekstisyötteestä. OpenAI kuvaa myös mallin lähtökuvien käsittelyn, muokkauksen ja yksittäisten alueiden muuttamisen. Nämä kyvyt vaativat erillisen kuvasyötteen tuen eivätkä kuulu tässä nimettyyn tekstipohjaiseen generointitapaan.
OpenAI:n erikseen tarjoamassa muokkaustoiminnossa maski toimii ohjenuorana: tuloksen tarkkaa vastaavuutta sen ääriviivoihin ei taata. Toiminto tarvitsee lähtökuvan lähettämisen tuen; nykyinen Ailoot-kortti koskee edelleen generointia tekstisyötteestä.
Tarjolla ovat neliökoko 1024x1024, vaakakoko 1536x1024 ja pystykoko 1024x1536 sekä automaattinen valinta. Muiden mallien vapaasti valittavia kokoja ei tule siirtää tähän versioon.
Laatutasot ovat low, medium, high ja auto. Laatuvalinta vaikuttaa käsittelyn määrään ja tuloksen yksityiskohtaisuuteen. Laatu ja koko ovat eri asetuksia: kuvan suunta määrittää sommittelutilan ja laatutaso sen muodostamistavan. Tasoja xhigh ja max ei ilmoiteta GPT Image 1.5:lle.
Tulos luodaan oletuksena PNG-muodossa; myös JPEG ja WebP ovat tarjolla. JPEG- ja WebP-muodoissa voidaan määrittää pakkausaste. Tämä on tulostiedoston asetus, joka eroaa generoinnin laadusta.
Valmistaja mahdollistaa läpinäkyvän ja peittävän taustan sekä automaattisen valinnan. Läpinäkyvyys vaatii PNG- tai WebP-muodon: JPEG ei säilytä alfakanavaa. Läpinäkyvä tausta on hyödyllinen, kun kuvaa käytetään erillisenä kohteena myöhemmässä sommitelmassa. Yksittäisten parametrien tuki on suhteutettava valittuun menetelmään.
Malli voi sisällyttää kuvaan tekstejä ja koota näkymän useista elementeistä, mutta tekstin ja kohteiden tarkkaa sijoittelua ei taata. Myös hahmon ulkonäön tai visuaalisen toteutuksen toistettavuutta erillisten generointien välillä on valvottava.
Vaativan kuvan muodostaminen voi kestää yksinkertaista pidempään; OpenAI:n mukaan yksittäiset vaativat tehtävät voivat kestää enintään kaksi minuuttia. Tulokseen vaikuttavat lähtökuvauksen täydellisyys ja valmiin kuvan tarkistus: tekstien luettavuus, yksityiskohtien sijainti ja vastaavuus annettuun näkymään arvioidaan itse tiedostosta.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gpt-image-1.5 | 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-1.5", "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-1.5', '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-1.5", "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-1.5
Ailoot Ultra gpt-image-1.5
Käytä yllä näytettyjä menetelmäpolkuja.
gpt-image-1.5GPT Image 1.5 luo kuvia tekstitehtävän perusteella painottaen yksityiskohtaisten ohjeiden noudattamista. Tarjolla on kolme kuvamuotoa sekä useita laatutasoja ja tulosformaatteja.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 1.5 on OpenAI:n malli kuvien luomiseen tekstikuvauksen perusteella. Valmistaja painottaa ohjeiden noudattamista ja yksityiskohtaisen tehtävän käsittelyä: siinä voidaan määrittää näkymän sisältö, sommittelu, kohteiden ulkonäkö ja haluttu tyyli. Kuvamenetelmän tulos on valmis kuva.
Ailootissa tämä kortti koskee generointia tekstisyötteestä. OpenAI kuvaa myös mallin lähtökuvien käsittelyn, muokkauksen ja yksittäisten alueiden muuttamisen. Nämä kyvyt vaativat erillisen kuvasyötteen tuen eivätkä kuulu tässä nimettyyn tekstipohjaiseen generointitapaan.
OpenAI:n erikseen tarjoamassa muokkaustoiminnossa maski toimii ohjenuorana: tuloksen tarkkaa vastaavuutta sen ääriviivoihin ei taata. Toiminto tarvitsee lähtökuvan lähettämisen tuen; nykyinen Ailoot-kortti koskee edelleen generointia tekstisyötteestä.
Tarjolla ovat neliökoko 1024x1024, vaakakoko 1536x1024 ja pystykoko 1024x1536 sekä automaattinen valinta. Muiden mallien vapaasti valittavia kokoja ei tule siirtää tähän versioon.
Laatutasot ovat low, medium, high ja auto. Laatuvalinta vaikuttaa käsittelyn määrään ja tuloksen yksityiskohtaisuuteen. Laatu ja koko ovat eri asetuksia: kuvan suunta määrittää sommittelutilan ja laatutaso sen muodostamistavan. Tasoja xhigh ja max ei ilmoiteta GPT Image 1.5:lle.
Tulos luodaan oletuksena PNG-muodossa; myös JPEG ja WebP ovat tarjolla. JPEG- ja WebP-muodoissa voidaan määrittää pakkausaste. Tämä on tulostiedoston asetus, joka eroaa generoinnin laadusta.
Valmistaja mahdollistaa läpinäkyvän ja peittävän taustan sekä automaattisen valinnan. Läpinäkyvyys vaatii PNG- tai WebP-muodon: JPEG ei säilytä alfakanavaa. Läpinäkyvä tausta on hyödyllinen, kun kuvaa käytetään erillisenä kohteena myöhemmässä sommitelmassa. Yksittäisten parametrien tuki on suhteutettava valittuun menetelmään.
Malli voi sisällyttää kuvaan tekstejä ja koota näkymän useista elementeistä, mutta tekstin ja kohteiden tarkkaa sijoittelua ei taata. Myös hahmon ulkonäön tai visuaalisen toteutuksen toistettavuutta erillisten generointien välillä on valvottava.
Vaativan kuvan muodostaminen voi kestää yksinkertaista pidempään; OpenAI:n mukaan yksittäiset vaativat tehtävät voivat kestää enintään kaksi minuuttia. Tulokseen vaikuttavat lähtökuvauksen täydellisyys ja valmiin kuvan tarkistus: tekstien luettavuus, yksityiskohtien sijainti ja vastaavuus annettuun näkymään arvioidaan itse tiedostosta.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gpt-image-1.5 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat Enimmäispituus: 32 000 | Oletus— |
Kenttäsize | Tyyppistring | VaatimusValinnainen | Arvot & rajat 1024x1024, 1536x1024, 1024x1536, auto | 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.32768 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-1.5', '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-1.5
Ailoot Ultra gpt-image-1.5
Käytä yllä näytettyjä menetelmäpolkuja.