GPT-5 Image Mini on yhdistetty kieli- ja kuvaprofiili, joka on rakennettu OpenAI:n GPT-5 Mini -mallin ja GPT Image 1 Mini -mallin ympärille. Sen kielikomponentti tulkitsee kirjallista tehtävää ja lähdeaineistoa, ja kuvakomponentti luo tai muokkaa visuaalista sisältöä. Julkaistu profiili korostaa ohjeiden noudattamista, tekstin tuottamista kuvaan ja yksityiskohtaista kuvamuokkausta. Se sopii rajattuun visuaaliseen tehtävänantoon, joka tarvitsee myös tekstin tulkintaa, selityksen tai tukitekstiä.
Valmistele tehtävänanto, joka sisältää tavoitellun tuotoksen, aiheen, sommittelun ja tarvittavan tekstin. Kuvaa kuvan käyttötapa, kuten tuotekonsepti, lyhyttä selitystä täydentävä kuvitus tai sivun visuaalinen luonnos. Pyydä kirjalliset ja visuaaliset tuotokset erikseen, jotta konseptin selitys on helppo erottaa itse kuvasta.
Anna esimerkiksi uudelleenkäytettävän vesipullon kuvaus ja pyydä yksinkertaista tuotekuvauskonseptia sekä lyhyttä kuvatekstiä. Määritä näkyvä pullon muoto, tausta, valon suunta ja kuvaan kuuluvat tarkat sanat. Pidä kuvatekstin faktat erillään kuvausympäristön koristeellisista yksityiskohdista. Tarkista palautettu kuva ja kirjallinen teksti suhteessa näihin kahteen tehtävänannon osaan.
Dokumentoitu yhdistelmäprofiili hyväksyy tekstiä, kuvia ja tiedostoja, kuten PDF:iä. Dokumentti voi antaa vaatimuksia tai faktoja tulkittavaksi ennen kuvan luomista. Kuva voi antaa ulkoasun, asettelun tai muokkauksen lähteen. Määritä jokaisen lähteen tehtävä sen sijaan, että olettaisit jokaisen liitteen vaikuttavan tuloksen jokaiseen osaan. Pidä lähdenimet ja järjestys selkeinä, kun syötteitä annetaan useita.
Määritä uuteen kuvaan näkyvät asiat ja niiden väliset suhteet. Osoita viitteen ohjaamassa muokkauksessa muutos ja säilytettävät yksityiskohdat. Tuotekuvassa voidaan pyytää uutta ympäristöä säilyttäen esineen tunnistettava muoto ja näkyvä etiketti. Kaaviossa voidaan pyytää korjattua suhdetta ja nimetä säilytettävät tekstit ja elementit.
Profiilin oma julkaistu kortti sallii muokkaukseen enintään kuuttatoista viitekuvaa. Valitse tehtävään vaikuttavat viitteet ja selitä niiden tarkoitus: tuote, hahmo, tausta tai visuaalinen käsittely. Useat viitteet voivat sisältää keskenään ristiriitaista valaistusta tai sommittelua, joten nimeä tavoiteltu tulos selkeästi. Tarkasta kohteen yksityiskohdat, kirjoitus ja pyydetyn muutoksen rajat todellisesta palautetusta kuvasta.
Tekstin tuottaminen kuvaan on dokumentoitu kyky, mutta visuaalinen luonnos tarvitsee silti sanakohtaisen tarkistuksen. Anna tarkka sanamuoto, välimerkit ja sijoittelu ja vertaa sitten tärkeitä merkintöjä ja numeroita tehtävänantoon tavoitellussa katselukoossa. Säilytä toistuvassa sarjassa viitteet ja visuaaliset vaatimukset yhdessä kunkin tuloksen kanssa ja vertaa valmiita kuvia keskenään.
Yhdistelmäprofiili julkaisee konteksti-ikkunaksi 400000 tokenia ja vastauksen enimmäispituudeksi 128000 tokenia. Nämä ovat työskentelykontekstin ja vastauksen rajoja, jotka ovat erillään kuvan pikselimitoista tai palautettujen kuvatuotosten määrästä. Järjestä pitkä lähdeaineisto tarvittavan tulkinnan ympärille ja jätä tilaa vastaukselle. Tiivis tehtävänanto olennaisine viitteineen on hyödyllisempi kuin asiaan liittymättömät dokumentit, joiden tehtävää ei ole selitetty.
Sen julkaistu tekstitulosteen määritys tukee JSON-skeeman mukaisia rakenteisia tuloksia. Määritä kentät ja tyypit, kun kirjallinen tulos pitää käyttää sovelluksessa, ja tarkista arvot annettua näyttöä vasten. Yhdistelmäprofiili ei tarjoa sovelluksen funktiokutsuja. Kielikomponentin käyttö kuvageneroinnin kanssa on nimetyn profiilin kyky; se ei tuo jokaista itsenäisen GPT-5 Mini -rajapinnan toimintoa tähän työnkulkuun.
Kuva-asetusten tulee perustua käytettävään täsmälliseen profiiliin ja rajapintaan. Säilytä valittu määritys yhdessä kehotteen kanssa versioita vertaillessasi. Suoralla GPT Image 1 Mini -komponentilla ja yhdistetyllä keskusteluprofiililla on erilaiset pyyntörakenteet, joten komponenttikohtaiset koko-, maskaus- tai tulosohjaimet tarvitsevat selkeän vastaavuuden ennen niiden käsittelyä tämän yhdistelmäprofiilin asetuksina.
Dokumentoitu keskustelupyynnön skeema voi valita text- ja image-tulostemuodot. Käsittele palautettu teksti ja jokainen vastaukseen liittyvä todellinen kuvatuotos. Tallenna kuvat tuloksen ilmoittamassa muodossa ja säilytä kirjallinen vastaus yhdessä kehotteen, lähdeviitteiden ja asetusten kanssa. Pelkän selittävän tekstin sisältävä vastaus eroaa valmiista visuaalisesta tuotoksesta, joten tarkista tuloksen todellinen sisältö ennen sen käyttöä asettelussa.
GPT-5 Image Mini eroaa täydestä GPT-5 Image -profiilista, joka yhdistää GPT-5:n ja GPT Image 1:n. Käytä Mini-profiilia rajattuihin kieli- ja kuvatehtäviin, joiden tehtävänanto ja tarkistuskriteerit ovat selkeät. Tarkista sommittelu, esineen tunnistettavuus, kuvan teksti ja tukiteksti ja pyydä sitten tarvittavaa täsmällistä korjausta. Säilytä onnistuneet elementit ja olennaiset viitteet seuraavassa tehtävänannossa, jotta muokkauksella on konkreettinen tavoite.
", "aboutText": "GPT-5 Image Mini on yhdistetty kieli- ja kuvaprofiili, joka on rakennettu OpenAI:n GPT-5 Mini -mallin ja GPT Image 1 Mini -mallin ympärille. Sen kielikomponentti tulkitsee kirjallista tehtävää ja lähdeaineistoa, ja kuvakomponentti luo tai muokkaa visuaalista sisältöä. Julkaistu profiili korostaa ohjeiden noudattamista, tekstin tuottamista kuvaan ja yksityiskohtaista kuvamuokkausta. Se sopii rajattuun visuaaliseen tehtävänantoon, joka tarvitsee myös tekstin tulkintaa, selityksen tai tukitekstiä.\n\n### Yhdistä kirjallinen tehtävä ja visuaalinen tulos\n\nValmistele tehtävänanto, joka sisältää tavoitellun tuotoksen, aiheen, sommittelun ja tarvittavan tekstin. Kuvaa kuvan käyttötapa, kuten tuotekonsepti, lyhyttä selitystä täydentävä kuvitus tai sivun visuaalinen luonnos. Pyydä kirjalliset ja visuaaliset tuotokset erikseen, jotta konseptin selitys on helppo erottaa itse kuvasta.\n\nAnna esimerkiksi uudelleenkäytettävän vesipullon kuvaus ja pyydä yksinkertaista tuotekuvauskonseptia sekä lyhyttä kuvatekstiä. Määritä näkyvä pullon muoto, tausta, valon suunta ja kuvaan kuuluvat tarkat sanat. Pidä kuvatekstin faktat erillään kuvausympäristön koristeellisista yksityiskohdista. Tarkista palautettu kuva ja kirjallinen teksti suhteessa näihin kahteen tehtävänannon osaan.\n\nDokumentoitu yhdistelmäprofiili hyväksyy tekstiä, kuvia ja tiedostoja, kuten PDF:iä. Dokumentti voi antaa vaatimuksia tai faktoja tulkittavaksi ennen kuvan luomista. Kuva voi antaa ulkoasun, asettelun tai muokkauksen lähteen. Määritä jokaisen lähteen tehtävä sen sijaan, että olettaisit jokaisen liitteen vaikuttavan tuloksen jokaiseen osaan. Pidä lähdenimet ja järjestys selkeinä, kun syötteitä annetaan useita.\n\n### Generoi ja muokkaa viitteiden avulla\n\nMääritä uuteen kuvaan näkyvät asiat ja niiden väliset suhteet. Osoita viitteen ohjaamassa muokkauksessa muutos ja säilytettävät yksityiskohdat. Tuotekuvassa voidaan pyytää uutta ympäristöä säilyttäen esineen tunnistettava muoto ja näkyvä etiketti. Kaaviossa voidaan pyytää korjattua suhdetta ja nimetä säilytettävät tekstit ja elementit.\n\nProfiilin oma julkaistu kortti sallii muokkaukseen enintään kuuttatoista viitekuvaa. Valitse tehtävään vaikuttavat viitteet ja selitä niiden tarkoitus: tuote, hahmo, tausta tai visuaalinen käsittely. Useat viitteet voivat sisältää keskenään ristiriitaista valaistusta tai sommittelua, joten nimeä tavoiteltu tulos selkeästi. Tarkasta kohteen yksityiskohdat, kirjoitus ja pyydetyn muutoksen rajat todellisesta palautetusta kuvasta.\n\nTekstin tuottaminen kuvaan on dokumentoitu kyky, mutta visuaalinen luonnos tarvitsee silti sanakohtaisen tarkistuksen. Anna tarkka sanamuoto, välimerkit ja sijoittelu ja vertaa sitten tärkeitä merkintöjä ja numeroita tehtävänantoon tavoitellussa katselukoossa. Säilytä toistuvassa sarjassa viitteet ja visuaaliset vaatimukset yhdessä kunkin tuloksen kanssa ja vertaa valmiita kuvia keskenään.\n\n### Työskentelykonteksti ja asetukset\n\nYhdistelmäprofiili julkaisee konteksti-ikkunaksi 400000 tokenia ja vastauksen enimmäispituudeksi 128000 tokenia. Nämä ovat työskentelykontekstin ja vastauksen rajoja, jotka ovat erillään kuvan pikselimitoista tai palautettujen kuvatuotosten määrästä. Järjestä pitkä lähdeaineisto tarvittavan tulkinnan ympärille ja jätä tilaa vastaukselle. Tiivis tehtävänanto olennaisine viitteineen on hyödyllisempi kuin asiaan liittymättömät dokumentit, joiden tehtävää ei ole selitetty.\n\nSen julkaistu tekstitulosteen määritys tukee JSON-skeeman mukaisia rakenteisia tuloksia. Määritä kentät ja tyypit, kun kirjallinen tulos pitää käyttää sovelluksessa, ja tarkista arvot annettua näyttöä vasten. Yhdistelmäprofiili ei tarjoa sovelluksen funktiokutsuja. Kielikomponentin käyttö kuvageneroinnin kanssa on nimetyn profiilin kyky; se ei tuo jokaista itsenäisen GPT-5 Mini -rajapinnan toimintoa tähän työnkulkuun.\n\nKuva-asetusten tulee perustua käytettävään täsmälliseen profiiliin ja rajapintaan. Säilytä valittu määritys yhdessä kehotteen kanssa versioita vertaillessasi. Suoralla GPT Image 1 Mini -komponentilla ja yhdistetyllä keskusteluprofiililla on erilaiset pyyntörakenteet, joten komponenttikohtaiset koko-, maskaus- tai tulosohjaimet tarvitsevat selkeän vastaavuuden ennen niiden käsittelyä tämän yhdistelmäprofiilin asetuksina.\n\n### Säilytä teksti- ja kuvatuotokset\n\nDokumentoitu keskustelupyynnön skeema voi valita text- ja image-tulostemuodot. Käsittele palautettu teksti ja jokainen vastaukseen liittyvä todellinen kuvatuotos. Tallenna kuvat tuloksen ilmoittamassa muodossa ja säilytä kirjallinen vastaus yhdessä kehotteen, lähdeviitteiden ja asetusten kanssa. Pelkän selittävän tekstin sisältävä vastaus eroaa valmiista visuaalisesta tuotoksesta, joten tarkista tuloksen todellinen sisältö ennen sen käyttöä asettelussa.\n\nGPT-5 Image Mini eroaa täydestä GPT-5 Image -profiilista, joka yhdistää GPT-5:n ja GPT Image 1:n. Käytä Mini-profiilia rajattuihin kieli- ja kuvatehtäviin, joiden tehtävänanto ja tarkistuskriteerit ovat selkeät. Tarkista sommittelu, esineen tunnistettavuus, kuvan teksti ja tukiteksti ja pyydä sitten tarvittavaa täsmällistä korjausta. Säilytä onnistuneet elementit ja olennaiset viitteet seuraavassa tehtävänannossa, jotta muokkauksella on konkreettinen tavoite.", "editorialOverlay": { "copy_fields": { "practical_html": "Tekninen esimerkki englanniksi
Create a labelled refill-bottle scene\n\nCreate a product-scene image of a plain cylindrical blue reusable water bottle with a silver screw cap, standing upright on pale stone. Soft daylight enters from the left. Place the exact word REFILL clearly on the bottle, with no other text, logos, accessories or unsupported product claims. Keep the full bottle visible.One image artifact showing the full specified bottle, left-side daylight and the exact single-word label.Inspect the actual image for bottle shape, cap, complete framing and letter-by-letter spelling of REFILL.openai/gpt-5-image-miniGPT-5 Image Mini yhdistää OpenAI:n GPT-5 Minin kielikyvyt GPT Image 1 Minin kuvien generointiin ja viitteiden ohjaamiin muokkauksiin. Se hyväksyy tekstiä, kuvia ja dokumentteja ja palauttaa tekstiä ja kuvia työnkulkuihin, jotka tarvitsevat sekä kirjallisen vastauksen että visuaalisen tuotoksen.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT-5 Image Mini on yhdistetty kieli- ja kuvaprofiili, joka on rakennettu OpenAI:n GPT-5 Mini -mallin ja GPT Image 1 Mini -mallin ympärille. Sen kielikomponentti tulkitsee kirjallista tehtävää ja lähdeaineistoa, ja kuvakomponentti luo tai muokkaa visuaalista sisältöä. Julkaistu profiili korostaa ohjeiden noudattamista, tekstin tuottamista kuvaan ja yksityiskohtaista kuvamuokkausta. Se sopii rajattuun visuaaliseen tehtävänantoon, joka tarvitsee myös tekstin tulkintaa, selityksen tai tukitekstiä.
Valmistele tehtävänanto, joka sisältää tavoitellun tuotoksen, aiheen, sommittelun ja tarvittavan tekstin. Kuvaa kuvan käyttötapa, kuten tuotekonsepti, lyhyttä selitystä täydentävä kuvitus tai sivun visuaalinen luonnos. Pyydä kirjalliset ja visuaaliset tuotokset erikseen, jotta konseptin selitys on helppo erottaa itse kuvasta.
Anna esimerkiksi uudelleenkäytettävän vesipullon kuvaus ja pyydä yksinkertaista tuotekuvauskonseptia sekä lyhyttä kuvatekstiä. Määritä näkyvä pullon muoto, tausta, valon suunta ja kuvaan kuuluvat tarkat sanat. Pidä kuvatekstin faktat erillään kuvausympäristön koristeellisista yksityiskohdista. Tarkista palautettu kuva ja kirjallinen teksti suhteessa näihin kahteen tehtävänannon osaan.
Dokumentoitu yhdistelmäprofiili hyväksyy tekstiä, kuvia ja tiedostoja, kuten PDF:iä. Dokumentti voi antaa vaatimuksia tai faktoja tulkittavaksi ennen kuvan luomista. Kuva voi antaa ulkoasun, asettelun tai muokkauksen lähteen. Määritä jokaisen lähteen tehtävä sen sijaan, että olettaisit jokaisen liitteen vaikuttavan tuloksen jokaiseen osaan. Pidä lähdenimet ja järjestys selkeinä, kun syötteitä annetaan useita.
Määritä uuteen kuvaan näkyvät asiat ja niiden väliset suhteet. Osoita viitteen ohjaamassa muokkauksessa muutos ja säilytettävät yksityiskohdat. Tuotekuvassa voidaan pyytää uutta ympäristöä säilyttäen esineen tunnistettava muoto ja näkyvä etiketti. Kaaviossa voidaan pyytää korjattua suhdetta ja nimetä säilytettävät tekstit ja elementit.
Profiilin oma julkaistu kortti sallii muokkaukseen enintään kuuttatoista viitekuvaa. Valitse tehtävään vaikuttavat viitteet ja selitä niiden tarkoitus: tuote, hahmo, tausta tai visuaalinen käsittely. Useat viitteet voivat sisältää keskenään ristiriitaista valaistusta tai sommittelua, joten nimeä tavoiteltu tulos selkeästi. Tarkasta kohteen yksityiskohdat, kirjoitus ja pyydetyn muutoksen rajat todellisesta palautetusta kuvasta.
Tekstin tuottaminen kuvaan on dokumentoitu kyky, mutta visuaalinen luonnos tarvitsee silti sanakohtaisen tarkistuksen. Anna tarkka sanamuoto, välimerkit ja sijoittelu ja vertaa sitten tärkeitä merkintöjä ja numeroita tehtävänantoon tavoitellussa katselukoossa. Säilytä toistuvassa sarjassa viitteet ja visuaaliset vaatimukset yhdessä kunkin tuloksen kanssa ja vertaa valmiita kuvia keskenään.
Yhdistelmäprofiili julkaisee konteksti-ikkunaksi 400000 tokenia ja vastauksen enimmäispituudeksi 128000 tokenia. Nämä ovat työskentelykontekstin ja vastauksen rajoja, jotka ovat erillään kuvan pikselimitoista tai palautettujen kuvatuotosten määrästä. Järjestä pitkä lähdeaineisto tarvittavan tulkinnan ympärille ja jätä tilaa vastaukselle. Tiivis tehtävänanto olennaisine viitteineen on hyödyllisempi kuin asiaan liittymättömät dokumentit, joiden tehtävää ei ole selitetty.
Sen julkaistu tekstitulosteen määritys tukee JSON-skeeman mukaisia rakenteisia tuloksia. Määritä kentät ja tyypit, kun kirjallinen tulos pitää käyttää sovelluksessa, ja tarkista arvot annettua näyttöä vasten. Yhdistelmäprofiili ei tarjoa sovelluksen funktiokutsuja. Kielikomponentin käyttö kuvageneroinnin kanssa on nimetyn profiilin kyky; se ei tuo jokaista itsenäisen GPT-5 Mini -rajapinnan toimintoa tähän työnkulkuun.
Kuva-asetusten tulee perustua käytettävään täsmälliseen profiiliin ja rajapintaan. Säilytä valittu määritys yhdessä kehotteen kanssa versioita vertaillessasi. Suoralla GPT Image 1 Mini -komponentilla ja yhdistetyllä keskusteluprofiililla on erilaiset pyyntörakenteet, joten komponenttikohtaiset koko-, maskaus- tai tulosohjaimet tarvitsevat selkeän vastaavuuden ennen niiden käsittelyä tämän yhdistelmäprofiilin asetuksina.
Dokumentoitu keskustelupyynnön skeema voi valita text- ja image-tulostemuodot. Käsittele palautettu teksti ja jokainen vastaukseen liittyvä todellinen kuvatuotos. Tallenna kuvat tuloksen ilmoittamassa muodossa ja säilytä kirjallinen vastaus yhdessä kehotteen, lähdeviitteiden ja asetusten kanssa. Pelkän selittävän tekstin sisältävä vastaus eroaa valmiista visuaalisesta tuotoksesta, joten tarkista tuloksen todellinen sisältö ennen sen käyttöä asettelussa.
GPT-5 Image Mini eroaa täydestä GPT-5 Image -profiilista, joka yhdistää GPT-5:n ja GPT Image 1:n. Käytä Mini-profiilia rajattuihin kieli- ja kuvatehtäviin, joiden tehtävänanto ja tarkistuskriteerit ovat selkeät. Tarkista sommittelu, esineen tunnistettavuus, kuvan teksti ja tukiteksti ja pyydä sitten tarvittavaa täsmällistä korjausta. Säilytä onnistuneet elementit ja olennaiset viitteet seuraavassa tehtävänannossa, jotta muokkauksella on konkreettinen tavoite.
POST /v1/chat/completionstexttext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat openai/gpt-5-image-mini | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat Esimerkit: system, user, assistant, tool, function Ehdot: Nämä roolit esitetään nimenomaisesti lähdekoodin yhteensopivuustyypeissä; mallin täsmällinen roolijoukko pysyy mallikohtaisena. Riippuu mallista | Oletus— |
Kenttämessages[].content | Tyyppistring|content_part[]|null | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_calls | Tyyppitool_call[] | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_call_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: role=tool; käytä todella palautettua ID:tä | Oletus— |
Kenttämessages[].name | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].reasoning_content | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Palauta todella saatu päättely takaisin mallille, kun kyseinen malli käyttää sitä | Oletus— |
Kenttämessages[].reasoning_details | Tyyppiobject|array | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— |
Kenttämax_completion_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttästream_options.include_usage | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätemperature | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätop_p | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttästop | Tyyppistring|string[] | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätools | Tyyppifunction_tool[] | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätools[].type | Tyyppistring | VaatimusValinnainen | Arvot & rajat function Riippuu mallista | Oletus— |
Kenttätools[].function.name | Tyyppistring | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: funktiotyökalu annettu | Oletus— |
Kenttätools[].function.description | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätools[].function.parameters | TyyppiJSON_schema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätool_choice | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäparallel_tool_calls | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäresponse_format | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäreasoning_effort | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäreasoning | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäservice_tier | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäinstructions | Tyyppistring | VaatimusValinnainen | Arvot & rajat Yhteensopivuuskenttä | Oletus— |
Kenttäfunctions | Tyyppifunction[] | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäfunction_call | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäprompt_cache_options | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttämodalities | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat text | Oletus— |
Kenttäprovider | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Ehdot: provider.options hylätään tällä Ultran tekstireitillä | Oletus— |
Kenttäcache_control.ttl | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: 1h hylätään varsinaisissa kehotevälimuistin kohdissa | Oletus— |
Teksti · UTF8-teksti
messages[].content
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages |
Parametrimaterial_types | Sopimustext |
Parametrimessages | Sopimusviestitaulukko role/content-rakenteella |
Parametrifile_material | Sopimusvarsinainen UTF-8-asiakirja lisätään sellaisenaan tekstinä; tiedoston ID:tä ei päätellä |
Parametrioptional_controls | Sopimusstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametricontrol_scope | Sopimusmallikohtainen; käyttäjän funktiotyökalut eroavat palvelun isännöimistä työkaluista |
Parametrioutput_modalities | Sopimustext |
Parametrihosted_operations | Sopimusfalse |
Parametrimultimodal_input_binding | Sopimusnull |
Elinkaari: synchronous_or_streamed
Lähetä mallin täsmällinen ID yhdessä messages-kentän kanssa.
Kontekstin pituus ei ole tuloksen yläraja.
Tekstitiedosto voi antaa tekstiä sellaisenaan; kuva-, ääni- ja tiedosto-objektisyötteet tarvitsevat täsmällisen sidonnan.
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 | Kontekstin tokenit, enemmän kuin | Kontekstin tokenit, enintään raja-arvo mukaan lukien | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Kontekstin tokenit, enemmän kuin— | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.005 / 1K tokenia Tuloste · Tulostokenit $0.004 / 1K tokenia Syöte · Välimuistin luku $0.0005 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia Tuloste · Kuvatulosteen tokenit $0.016 / 1K kuvatokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.005 / 1K tokenia Tuloste · Tulostokenit $0.004 / 1K tokenia Syöte · Välimuistin luku $0.0005 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.
| Asetukset | Laskutusehdot | Veloitus |
|---|---|---|
| AsetuksetOpenAI: GPT-5 Image Mini · Oletusasetukset | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syötetokenit 0,005 $ / 1K tokenia Tuloste · Tulostokenit 0,004 $ / 1K tokenia Tuloste · Kuvatuloste 0,016 $ / 1K tokenia Tuloste · Verkkohaku 0,02 $ hakua kohden Syöte · Välimuistin luku 0,0005 $ / 1K tokenia |
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}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "openai/gpt-5-image-mini", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\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/chat/completions \\\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 json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='openai/gpt-5-image-mini',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='openai/gpt-5-image-mini',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä jokainen vastausvaihtoehto sisältöineen, työkalukutsuineen ja päättelyineen. Kokoa SSE:ssä muutokset vastausvaihtoehdon ja työkalun indeksin mukaan ja säilytä lopullinen päättymissyy sekä käyttötiedot.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttächoices[].index | Tyyppiinteger |
Kenttächoices[].message.content | Tyyppistring|null |
Kenttächoices[].message.tool_calls | Tyyppitool_call[] |
Kenttächoices[].message.reasoning_content | Tyyppistring |
Kenttächoices[].message.reasoning_details | Tyyppiobject|array |
Kenttächoices[].finish_reason | Tyyppistring|null |
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öä. |
Ailoot Ultra openai/gpt-5-image-mini
/v1/images
openai/gpt-5-image-miniGPT-5 Image Mini yhdistää OpenAI:n GPT-5 Minin kielikyvyt GPT Image 1 Minin kuvien generointiin ja viitteiden ohjaamiin muokkauksiin. Se hyväksyy tekstiä, kuvia ja dokumentteja ja palauttaa tekstiä ja kuvia työnkulkuihin, jotka tarvitsevat sekä kirjallisen vastauksen että visuaalisen tuotoksen.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT-5 Image Mini on yhdistetty kieli- ja kuvaprofiili, joka on rakennettu OpenAI:n GPT-5 Mini -mallin ja GPT Image 1 Mini -mallin ympärille. Sen kielikomponentti tulkitsee kirjallista tehtävää ja lähdeaineistoa, ja kuvakomponentti luo tai muokkaa visuaalista sisältöä. Julkaistu profiili korostaa ohjeiden noudattamista, tekstin tuottamista kuvaan ja yksityiskohtaista kuvamuokkausta. Se sopii rajattuun visuaaliseen tehtävänantoon, joka tarvitsee myös tekstin tulkintaa, selityksen tai tukitekstiä.
Valmistele tehtävänanto, joka sisältää tavoitellun tuotoksen, aiheen, sommittelun ja tarvittavan tekstin. Kuvaa kuvan käyttötapa, kuten tuotekonsepti, lyhyttä selitystä täydentävä kuvitus tai sivun visuaalinen luonnos. Pyydä kirjalliset ja visuaaliset tuotokset erikseen, jotta konseptin selitys on helppo erottaa itse kuvasta.
Anna esimerkiksi uudelleenkäytettävän vesipullon kuvaus ja pyydä yksinkertaista tuotekuvauskonseptia sekä lyhyttä kuvatekstiä. Määritä näkyvä pullon muoto, tausta, valon suunta ja kuvaan kuuluvat tarkat sanat. Pidä kuvatekstin faktat erillään kuvausympäristön koristeellisista yksityiskohdista. Tarkista palautettu kuva ja kirjallinen teksti suhteessa näihin kahteen tehtävänannon osaan.
Dokumentoitu yhdistelmäprofiili hyväksyy tekstiä, kuvia ja tiedostoja, kuten PDF:iä. Dokumentti voi antaa vaatimuksia tai faktoja tulkittavaksi ennen kuvan luomista. Kuva voi antaa ulkoasun, asettelun tai muokkauksen lähteen. Määritä jokaisen lähteen tehtävä sen sijaan, että olettaisit jokaisen liitteen vaikuttavan tuloksen jokaiseen osaan. Pidä lähdenimet ja järjestys selkeinä, kun syötteitä annetaan useita.
Määritä uuteen kuvaan näkyvät asiat ja niiden väliset suhteet. Osoita viitteen ohjaamassa muokkauksessa muutos ja säilytettävät yksityiskohdat. Tuotekuvassa voidaan pyytää uutta ympäristöä säilyttäen esineen tunnistettava muoto ja näkyvä etiketti. Kaaviossa voidaan pyytää korjattua suhdetta ja nimetä säilytettävät tekstit ja elementit.
Profiilin oma julkaistu kortti sallii muokkaukseen enintään kuuttatoista viitekuvaa. Valitse tehtävään vaikuttavat viitteet ja selitä niiden tarkoitus: tuote, hahmo, tausta tai visuaalinen käsittely. Useat viitteet voivat sisältää keskenään ristiriitaista valaistusta tai sommittelua, joten nimeä tavoiteltu tulos selkeästi. Tarkasta kohteen yksityiskohdat, kirjoitus ja pyydetyn muutoksen rajat todellisesta palautetusta kuvasta.
Tekstin tuottaminen kuvaan on dokumentoitu kyky, mutta visuaalinen luonnos tarvitsee silti sanakohtaisen tarkistuksen. Anna tarkka sanamuoto, välimerkit ja sijoittelu ja vertaa sitten tärkeitä merkintöjä ja numeroita tehtävänantoon tavoitellussa katselukoossa. Säilytä toistuvassa sarjassa viitteet ja visuaaliset vaatimukset yhdessä kunkin tuloksen kanssa ja vertaa valmiita kuvia keskenään.
Yhdistelmäprofiili julkaisee konteksti-ikkunaksi 400000 tokenia ja vastauksen enimmäispituudeksi 128000 tokenia. Nämä ovat työskentelykontekstin ja vastauksen rajoja, jotka ovat erillään kuvan pikselimitoista tai palautettujen kuvatuotosten määrästä. Järjestä pitkä lähdeaineisto tarvittavan tulkinnan ympärille ja jätä tilaa vastaukselle. Tiivis tehtävänanto olennaisine viitteineen on hyödyllisempi kuin asiaan liittymättömät dokumentit, joiden tehtävää ei ole selitetty.
Sen julkaistu tekstitulosteen määritys tukee JSON-skeeman mukaisia rakenteisia tuloksia. Määritä kentät ja tyypit, kun kirjallinen tulos pitää käyttää sovelluksessa, ja tarkista arvot annettua näyttöä vasten. Yhdistelmäprofiili ei tarjoa sovelluksen funktiokutsuja. Kielikomponentin käyttö kuvageneroinnin kanssa on nimetyn profiilin kyky; se ei tuo jokaista itsenäisen GPT-5 Mini -rajapinnan toimintoa tähän työnkulkuun.
Kuva-asetusten tulee perustua käytettävään täsmälliseen profiiliin ja rajapintaan. Säilytä valittu määritys yhdessä kehotteen kanssa versioita vertaillessasi. Suoralla GPT Image 1 Mini -komponentilla ja yhdistetyllä keskusteluprofiililla on erilaiset pyyntörakenteet, joten komponenttikohtaiset koko-, maskaus- tai tulosohjaimet tarvitsevat selkeän vastaavuuden ennen niiden käsittelyä tämän yhdistelmäprofiilin asetuksina.
Dokumentoitu keskustelupyynnön skeema voi valita text- ja image-tulostemuodot. Käsittele palautettu teksti ja jokainen vastaukseen liittyvä todellinen kuvatuotos. Tallenna kuvat tuloksen ilmoittamassa muodossa ja säilytä kirjallinen vastaus yhdessä kehotteen, lähdeviitteiden ja asetusten kanssa. Pelkän selittävän tekstin sisältävä vastaus eroaa valmiista visuaalisesta tuotoksesta, joten tarkista tuloksen todellinen sisältö ennen sen käyttöä asettelussa.
GPT-5 Image Mini eroaa täydestä GPT-5 Image -profiilista, joka yhdistää GPT-5:n ja GPT Image 1:n. Käytä Mini-profiilia rajattuihin kieli- ja kuvatehtäviin, joiden tehtävänanto ja tarkistuskriteerit ovat selkeät. Tarkista sommittelu, esineen tunnistettavuus, kuvan teksti ja tukiteksti ja pyydä sitten tarvittavaa täsmällistä korjausta. Säilytä onnistuneet elementit ja olennaiset viitteet seuraavassa tehtävänannossa, jotta muokkauksella on konkreettinen tavoite.
POST /v1/images/generationstext, imageimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat openai/gpt-5-image-mini | 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, auto | Oletus— |
Kenttäquality | Tyyppistring | VaatimusValinnainen | Arvot & rajat auto, low, medium, high | 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.065536 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-5-image-mini', '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 Ultra openai/gpt-5-image-mini
/v1/images
openai/gpt-5-image-miniGPT-5 Image Mini yhdistää OpenAI:n GPT-5 Minin kielikyvyt GPT Image 1 Minin kuvien generointiin ja viitteiden ohjaamiin muokkauksiin. Se hyväksyy tekstiä, kuvia ja dokumentteja ja palauttaa tekstiä ja kuvia työnkulkuihin, jotka tarvitsevat sekä kirjallisen vastauksen että visuaalisen tuotoksen.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT-5 Image Mini on yhdistetty kieli- ja kuvaprofiili, joka on rakennettu OpenAI:n GPT-5 Mini -mallin ja GPT Image 1 Mini -mallin ympärille. Sen kielikomponentti tulkitsee kirjallista tehtävää ja lähdeaineistoa, ja kuvakomponentti luo tai muokkaa visuaalista sisältöä. Julkaistu profiili korostaa ohjeiden noudattamista, tekstin tuottamista kuvaan ja yksityiskohtaista kuvamuokkausta. Se sopii rajattuun visuaaliseen tehtävänantoon, joka tarvitsee myös tekstin tulkintaa, selityksen tai tukitekstiä.
Valmistele tehtävänanto, joka sisältää tavoitellun tuotoksen, aiheen, sommittelun ja tarvittavan tekstin. Kuvaa kuvan käyttötapa, kuten tuotekonsepti, lyhyttä selitystä täydentävä kuvitus tai sivun visuaalinen luonnos. Pyydä kirjalliset ja visuaaliset tuotokset erikseen, jotta konseptin selitys on helppo erottaa itse kuvasta.
Anna esimerkiksi uudelleenkäytettävän vesipullon kuvaus ja pyydä yksinkertaista tuotekuvauskonseptia sekä lyhyttä kuvatekstiä. Määritä näkyvä pullon muoto, tausta, valon suunta ja kuvaan kuuluvat tarkat sanat. Pidä kuvatekstin faktat erillään kuvausympäristön koristeellisista yksityiskohdista. Tarkista palautettu kuva ja kirjallinen teksti suhteessa näihin kahteen tehtävänannon osaan.
Dokumentoitu yhdistelmäprofiili hyväksyy tekstiä, kuvia ja tiedostoja, kuten PDF:iä. Dokumentti voi antaa vaatimuksia tai faktoja tulkittavaksi ennen kuvan luomista. Kuva voi antaa ulkoasun, asettelun tai muokkauksen lähteen. Määritä jokaisen lähteen tehtävä sen sijaan, että olettaisit jokaisen liitteen vaikuttavan tuloksen jokaiseen osaan. Pidä lähdenimet ja järjestys selkeinä, kun syötteitä annetaan useita.
Määritä uuteen kuvaan näkyvät asiat ja niiden väliset suhteet. Osoita viitteen ohjaamassa muokkauksessa muutos ja säilytettävät yksityiskohdat. Tuotekuvassa voidaan pyytää uutta ympäristöä säilyttäen esineen tunnistettava muoto ja näkyvä etiketti. Kaaviossa voidaan pyytää korjattua suhdetta ja nimetä säilytettävät tekstit ja elementit.
Profiilin oma julkaistu kortti sallii muokkaukseen enintään kuuttatoista viitekuvaa. Valitse tehtävään vaikuttavat viitteet ja selitä niiden tarkoitus: tuote, hahmo, tausta tai visuaalinen käsittely. Useat viitteet voivat sisältää keskenään ristiriitaista valaistusta tai sommittelua, joten nimeä tavoiteltu tulos selkeästi. Tarkasta kohteen yksityiskohdat, kirjoitus ja pyydetyn muutoksen rajat todellisesta palautetusta kuvasta.
Tekstin tuottaminen kuvaan on dokumentoitu kyky, mutta visuaalinen luonnos tarvitsee silti sanakohtaisen tarkistuksen. Anna tarkka sanamuoto, välimerkit ja sijoittelu ja vertaa sitten tärkeitä merkintöjä ja numeroita tehtävänantoon tavoitellussa katselukoossa. Säilytä toistuvassa sarjassa viitteet ja visuaaliset vaatimukset yhdessä kunkin tuloksen kanssa ja vertaa valmiita kuvia keskenään.
Yhdistelmäprofiili julkaisee konteksti-ikkunaksi 400000 tokenia ja vastauksen enimmäispituudeksi 128000 tokenia. Nämä ovat työskentelykontekstin ja vastauksen rajoja, jotka ovat erillään kuvan pikselimitoista tai palautettujen kuvatuotosten määrästä. Järjestä pitkä lähdeaineisto tarvittavan tulkinnan ympärille ja jätä tilaa vastaukselle. Tiivis tehtävänanto olennaisine viitteineen on hyödyllisempi kuin asiaan liittymättömät dokumentit, joiden tehtävää ei ole selitetty.
Sen julkaistu tekstitulosteen määritys tukee JSON-skeeman mukaisia rakenteisia tuloksia. Määritä kentät ja tyypit, kun kirjallinen tulos pitää käyttää sovelluksessa, ja tarkista arvot annettua näyttöä vasten. Yhdistelmäprofiili ei tarjoa sovelluksen funktiokutsuja. Kielikomponentin käyttö kuvageneroinnin kanssa on nimetyn profiilin kyky; se ei tuo jokaista itsenäisen GPT-5 Mini -rajapinnan toimintoa tähän työnkulkuun.
Kuva-asetusten tulee perustua käytettävään täsmälliseen profiiliin ja rajapintaan. Säilytä valittu määritys yhdessä kehotteen kanssa versioita vertaillessasi. Suoralla GPT Image 1 Mini -komponentilla ja yhdistetyllä keskusteluprofiililla on erilaiset pyyntörakenteet, joten komponenttikohtaiset koko-, maskaus- tai tulosohjaimet tarvitsevat selkeän vastaavuuden ennen niiden käsittelyä tämän yhdistelmäprofiilin asetuksina.
Dokumentoitu keskustelupyynnön skeema voi valita text- ja image-tulostemuodot. Käsittele palautettu teksti ja jokainen vastaukseen liittyvä todellinen kuvatuotos. Tallenna kuvat tuloksen ilmoittamassa muodossa ja säilytä kirjallinen vastaus yhdessä kehotteen, lähdeviitteiden ja asetusten kanssa. Pelkän selittävän tekstin sisältävä vastaus eroaa valmiista visuaalisesta tuotoksesta, joten tarkista tuloksen todellinen sisältö ennen sen käyttöä asettelussa.
GPT-5 Image Mini eroaa täydestä GPT-5 Image -profiilista, joka yhdistää GPT-5:n ja GPT Image 1:n. Käytä Mini-profiilia rajattuihin kieli- ja kuvatehtäviin, joiden tehtävänanto ja tarkistuskriteerit ovat selkeät. Tarkista sommittelu, esineen tunnistettavuus, kuvan teksti ja tukiteksti ja pyydä sitten tarvittavaa täsmällistä korjausta. Säilytä onnistuneet elementit ja olennaiset viitteet seuraavassa tehtävänannossa, jotta muokkauksella on konkreettinen tavoite.
POST /v1/messagestextjson, sse| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat openai/gpt-5-image-mini | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat user, assistant | Oletus— |
Kenttämessages[].content | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Teksti · UTF-8-teksti
messages[].content-merkkijono
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages, max_tokens |
Parametrioptional_controls | Sopimusstream |
Parametrimaterial_types | Sopimustext |
Parametritext_file_material | SopimusLue varsinainen UTF-8-asiakirja ja sijoita sen teksti ilmoitettuun syöte- tai viestisisällön merkkijonoon. |
Elinkaari: synchronous_or_streamed
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 | Kontekstin tokenit, enemmän kuin | Kontekstin tokenit, enintään raja-arvo mukaan lukien | Veloitus |
|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Kontekstin tokenit, enemmän kuin— | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.005 / 1K tokenia Tuloste · Tulostokenit $0.004 / 1K tokenia Syöte · Välimuistin luku $0.0005 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia Tuloste · Kuvatulosteen tokenit $0.016 / 1K kuvatokenia |
| AsetuksetPyynnön pituusluokka 1 | Hinnasto— | Kontekstin tokenit, enemmän kuin0 | Kontekstin tokenit, enintään raja-arvo mukaan lukienEi ylärajaa | Veloitus Syöte · Syötetokenit $0.005 / 1K tokenia Tuloste · Tulostokenit $0.004 / 1K tokenia Syöte · Välimuistin luku $0.0005 / 1K tokenia Syöte · Välimuistiin kirjoitus — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
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 →
{\n "model": "openai/gpt-5-image-mini",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'openai/gpt-5-image-mini', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'openai/gpt-5-image-mini', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä kaikki sisältölohkot, päättelyallekirjoitukset ja todelliset työkalukäytön ID:t. Kokoa kaikki SSE-lohkomuutokset; ensimmäinen tekstilohko ei ole koko tulos.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäcontent[] | Tyyppitext|thinking|tool_use|other content block |
Kenttästop_reason | Tyyppistring|null |
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öä. |
Ailoot Ultra openai/gpt-5-image-mini
/v1/images
Tekninen esimerkki englanniksi
Create a labelled refill-bottle scene\n\nCreate a product-scene image of a plain cylindrical blue reusable water bottle with a silver screw cap, standing upright on pale stone. Soft daylight enters from the left. Place the exact word REFILL clearly on the bottle, with no other text, logos, accessories or unsupported product claims. Keep the full bottle visible.One image artifact showing the full specified bottle, left-side daylight and the exact single-word label.Inspect the actual image for bottle shape, cap, complete framing and letter-by-letter spelling of REFILL.