GPT Image 1 Mini on OpenAI:n nimetty Mini-versio GPT Image 1 -perheessä. Se hyväksyy tekstiä ja kuvia ja tuottaa kuvia tuottajan generointi- ja muokkaustyönkulkujen kautta. Käytä sitä tavallisiin luoviin tehtävänantoihin, visuaalisiin konsepteihin ja annetun kuvan muutoksiin, kun Mini-version dokumentoidut asetukset sopivat tehtävään. Käytä tehtävää valmistellessasi Minin vakiokuvakokoja ja input_fidelity-asetuksen low-arvoa.
Kuvaa uuteen kuvaan kohde, näkymä, valo, sommittelu ja tyyli. Osoita muokkaukseen tarvittava muutos ja lähteen elementit, joiden tulee pysyä tunnistettavina. Yksinkertainen kuvitustehtävänanto voi pyytää lähettipyörää oviaukon vieressä, suuria selkeitä muotoja ja hillittyä väripalettia; jatkopyyntö voi vaihtaa taustan säilyttäen valitun sommittelun. Dokumentoiduissa suorissa työnkuluissa kehote voi sisältää enintään 32000 merkkiä ja tulosteita voi olla yhdestä kymmeneen. Tulokset voivat antaa vaihtoehtoja tarkasteluun.
Muokkaus voi käyttää enintään kuuttatoista syötekuvaa. Selitä, mikä kuva antaa pääkohteen, ympäristön tai visuaalisen käsittelyn, sen sijaan että jättäisit roolit epäselviksi. GPT Image 1 Mini tukee input_fidelity-asetukselle vain arvoa low. GPT Image 1 -mallin high-asetus ei ole Minin vaihtoehto. Syötteen vastaavuus eroaa tulosteen renderöintilaadusta: korkealaatuisen tulosteen valinta ei ota käyttöön erilaista lähteen säilyttämistilaa. Pidä säilyttämisvaatimukset selkeinä ja tarkasta olennaiset lähdeyksityiskohdat syntyneestä tuotoksesta.
Maski voi ohjata pyydetyn muutoksen valittuun alueeseen. Lähteellä ja maskilla pitää olla sama muoto ja samat mitat, ja maski tarvitsee alfakanavan; kuvageneroinnin opas määrittää alle 50 MB:n kokovaatimuksen. Useita lähdekuvia käytettäessä maski koskee ensimmäistä. Rajattu tehtävänanto voi muuttaa yhden esineen väriä säilyttäen näkymän yleisen rajauksen. Maski on kehotteeseen perustuva ohje eikä taattu geometrinen raja, joten tarkasta myös viereinen alue tavoitellun muutoksen lisäksi.
Vakiokuvakoot ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536 pikseliä, ja automaattinen valinta on käytettävissä sitä tukevissa rajapinnoissa. Renderöintilaadun vaihtoehdot ovat low, medium, high ja auto. Ne ovat erillään Minin syötteen vastaavuudesta, joka tukee vain low-arvoa. Myöhempien GPT Image -versioiden mukautetut suuren tarkkuuden mitat sekä xhigh- ja max-tasot eivät kuulu tähän Mini-profiiliin. Valitse käyttökohteeseen sopiva kuvakoko ja luonnokselle tai valmiille tuotokselle sopiva laatutaso.
Tuottaja tukee PNG-, JPEG- ja WebP-tulosteita, joista PNG on oletus. JPEG ja WebP voivat käyttää pakkausta väliltä 0–100. Läpinäkyvä, läpinäkymätön ja automaattinen tausta palvelevat eri asetteluvaatimuksia; valitse PNG tai WebP, kun alfakanavaa tarvitaan. Läpinäkyvä esine voidaan sijoittaa erilliseen sommitelmaan, ja läpinäkymätön näkymä sisältää oman taustansa. Säilytä valittu tulostiedosto sen sijaan, että käsittelisit sen koodattua toimitusesitystä lopullisena suunnittelutuotoksena.
Tuottajan kuvaviite dokumentoi suoratoiston, jossa voi olla enintään kolme osittaista kuvaa ennen valmistumista. Esikatselu voi näyttää edistymisen, mutta vain lopullinen kuva tulee säilyttää valmiina tuloksena. Anna muokkaussarjassa valittu kuva uudelleen seuraavan konkreettisen ohjeen kanssa. Valmistajan rajapinta tukee myös eräkäsittelyä.
Tarkasta kuvan kirjoitus, asettelulle herkät yksityiskohdat ja lähde-esineen ulkonäkö tehtävänantoa vasten. GPT Image voi edelleen kohdata vaikeuksia tekstin täsmällisessä sijoittelussa, rakenteisissa sommitteluissa ja saman kohteen yhdenmukaisessa toistamisessa eri generoinneissa. Käytä valittua tulosta rajattuun muokkaukseen, kun näkyvä yksityiskohta tarvitsee muutosta, ja pidä sekä muutos- että säilyttämisvaatimukset selkeinä. Hyödyllinen Mini-tulos on valmis kuva määritettyyn luovaan tehtävään, valmisteltuna juuri tämän version tarjoamilla vakiokoko- ja vastaavuusasetuksilla.
", "aboutText": "GPT Image 1 Mini on OpenAI:n nimetty Mini-versio GPT Image 1 -perheessä. Se hyväksyy tekstiä ja kuvia ja tuottaa kuvia tuottajan generointi- ja muokkaustyönkulkujen kautta. Käytä sitä tavallisiin luoviin tehtävänantoihin, visuaalisiin konsepteihin ja annetun kuvan muutoksiin, kun Mini-version dokumentoidut asetukset sopivat tehtävään. Käytä tehtävää valmistellessasi Minin vakiokuvakokoja ja input_fidelity-asetuksen low-arvoa.\n\nKuvaa uuteen kuvaan kohde, näkymä, valo, sommittelu ja tyyli. Osoita muokkaukseen tarvittava muutos ja lähteen elementit, joiden tulee pysyä tunnistettavina. Yksinkertainen kuvitustehtävänanto voi pyytää lähettipyörää oviaukon vieressä, suuria selkeitä muotoja ja hillittyä väripalettia; jatkopyyntö voi vaihtaa taustan säilyttäen valitun sommittelun. Dokumentoiduissa suorissa työnkuluissa kehote voi sisältää enintään 32000 merkkiä ja tulosteita voi olla yhdestä kymmeneen. Tulokset voivat antaa vaihtoehtoja tarkasteluun.\n\nMuokkaus voi käyttää enintään kuuttatoista syötekuvaa. Selitä, mikä kuva antaa pääkohteen, ympäristön tai visuaalisen käsittelyn, sen sijaan että jättäisit roolit epäselviksi. GPT Image 1 Mini tukee input_fidelity-asetukselle vain arvoa low. GPT Image 1 -mallin high-asetus ei ole Minin vaihtoehto. Syötteen vastaavuus eroaa tulosteen renderöintilaadusta: korkealaatuisen tulosteen valinta ei ota käyttöön erilaista lähteen säilyttämistilaa. Pidä säilyttämisvaatimukset selkeinä ja tarkasta olennaiset lähdeyksityiskohdat syntyneestä tuotoksesta.\n\nMaski voi ohjata pyydetyn muutoksen valittuun alueeseen. Lähteellä ja maskilla pitää olla sama muoto ja samat mitat, ja maski tarvitsee alfakanavan; kuvageneroinnin opas määrittää alle 50 MB:n kokovaatimuksen. Useita lähdekuvia käytettäessä maski koskee ensimmäistä. Rajattu tehtävänanto voi muuttaa yhden esineen väriä säilyttäen näkymän yleisen rajauksen. Maski on kehotteeseen perustuva ohje eikä taattu geometrinen raja, joten tarkasta myös viereinen alue tavoitellun muutoksen lisäksi.\n\nVakiokuvakoot ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536 pikseliä, ja automaattinen valinta on käytettävissä sitä tukevissa rajapinnoissa. Renderöintilaadun vaihtoehdot ovat low, medium, high ja auto. Ne ovat erillään Minin syötteen vastaavuudesta, joka tukee vain low-arvoa. Myöhempien GPT Image -versioiden mukautetut suuren tarkkuuden mitat sekä xhigh- ja max-tasot eivät kuulu tähän Mini-profiiliin. Valitse käyttökohteeseen sopiva kuvakoko ja luonnokselle tai valmiille tuotokselle sopiva laatutaso.\n\nTuottaja tukee PNG-, JPEG- ja WebP-tulosteita, joista PNG on oletus. JPEG ja WebP voivat käyttää pakkausta väliltä 0–100. Läpinäkyvä, läpinäkymätön ja automaattinen tausta palvelevat eri asetteluvaatimuksia; valitse PNG tai WebP, kun alfakanavaa tarvitaan. Läpinäkyvä esine voidaan sijoittaa erilliseen sommitelmaan, ja läpinäkymätön näkymä sisältää oman taustansa. Säilytä valittu tulostiedosto sen sijaan, että käsittelisit sen koodattua toimitusesitystä lopullisena suunnittelutuotoksena.\n\nTuottajan kuvaviite dokumentoi suoratoiston, jossa voi olla enintään kolme osittaista kuvaa ennen valmistumista. Esikatselu voi näyttää edistymisen, mutta vain lopullinen kuva tulee säilyttää valmiina tuloksena. Anna muokkaussarjassa valittu kuva uudelleen seuraavan konkreettisen ohjeen kanssa. Valmistajan rajapinta tukee myös eräkäsittelyä.\n\nTarkasta kuvan kirjoitus, asettelulle herkät yksityiskohdat ja lähde-esineen ulkonäkö tehtävänantoa vasten. GPT Image voi edelleen kohdata vaikeuksia tekstin täsmällisessä sijoittelussa, rakenteisissa sommitteluissa ja saman kohteen yhdenmukaisessa toistamisessa eri generoinneissa. Käytä valittua tulosta rajattuun muokkaukseen, kun näkyvä yksityiskohta tarvitsee muutosta, ja pidä sekä muutos- että säilyttämisvaatimukset selkeinä. Hyödyllinen Mini-tulos on valmis kuva määritettyyn luovaan tehtävään, valmisteltuna juuri tämän version tarjoamilla vakiokoko- ja vastaavuusasetuksilla.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "03aa3d794752a1100b9442d37ebc34daa1bcb465ef2aed1bff5d4f1fff86fe98", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "openai/gpt-image-1-miniGPT Image 1 Mini luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä GPT Image 1 -perheessä. Se tukee vakiokokoja, maskeja ja yleisiä kuvamuotoja sekä input_fidelity-asetuksen low-arvoa GPT Image 1 -mallin high-vaihtoehdon sijaan.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 1 Mini on OpenAI:n nimetty Mini-versio GPT Image 1 -perheessä. Se hyväksyy tekstiä ja kuvia ja tuottaa kuvia tuottajan generointi- ja muokkaustyönkulkujen kautta. Käytä sitä tavallisiin luoviin tehtävänantoihin, visuaalisiin konsepteihin ja annetun kuvan muutoksiin, kun Mini-version dokumentoidut asetukset sopivat tehtävään. Käytä tehtävää valmistellessasi Minin vakiokuvakokoja ja input_fidelity-asetuksen low-arvoa.
Kuvaa uuteen kuvaan kohde, näkymä, valo, sommittelu ja tyyli. Osoita muokkaukseen tarvittava muutos ja lähteen elementit, joiden tulee pysyä tunnistettavina. Yksinkertainen kuvitustehtävänanto voi pyytää lähettipyörää oviaukon vieressä, suuria selkeitä muotoja ja hillittyä väripalettia; jatkopyyntö voi vaihtaa taustan säilyttäen valitun sommittelun. Dokumentoiduissa suorissa työnkuluissa kehote voi sisältää enintään 32000 merkkiä ja tulosteita voi olla yhdestä kymmeneen. Tulokset voivat antaa vaihtoehtoja tarkasteluun.
Muokkaus voi käyttää enintään kuuttatoista syötekuvaa. Selitä, mikä kuva antaa pääkohteen, ympäristön tai visuaalisen käsittelyn, sen sijaan että jättäisit roolit epäselviksi. GPT Image 1 Mini tukee input_fidelity-asetukselle vain arvoa low. GPT Image 1 -mallin high-asetus ei ole Minin vaihtoehto. Syötteen vastaavuus eroaa tulosteen renderöintilaadusta: korkealaatuisen tulosteen valinta ei ota käyttöön erilaista lähteen säilyttämistilaa. Pidä säilyttämisvaatimukset selkeinä ja tarkasta olennaiset lähdeyksityiskohdat syntyneestä tuotoksesta.
Maski voi ohjata pyydetyn muutoksen valittuun alueeseen. Lähteellä ja maskilla pitää olla sama muoto ja samat mitat, ja maski tarvitsee alfakanavan; kuvageneroinnin opas määrittää alle 50 MB:n kokovaatimuksen. Useita lähdekuvia käytettäessä maski koskee ensimmäistä. Rajattu tehtävänanto voi muuttaa yhden esineen väriä säilyttäen näkymän yleisen rajauksen. Maski on kehotteeseen perustuva ohje eikä taattu geometrinen raja, joten tarkasta myös viereinen alue tavoitellun muutoksen lisäksi.
Vakiokuvakoot ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536 pikseliä, ja automaattinen valinta on käytettävissä sitä tukevissa rajapinnoissa. Renderöintilaadun vaihtoehdot ovat low, medium, high ja auto. Ne ovat erillään Minin syötteen vastaavuudesta, joka tukee vain low-arvoa. Myöhempien GPT Image -versioiden mukautetut suuren tarkkuuden mitat sekä xhigh- ja max-tasot eivät kuulu tähän Mini-profiiliin. Valitse käyttökohteeseen sopiva kuvakoko ja luonnokselle tai valmiille tuotokselle sopiva laatutaso.
Tuottaja tukee PNG-, JPEG- ja WebP-tulosteita, joista PNG on oletus. JPEG ja WebP voivat käyttää pakkausta väliltä 0–100. Läpinäkyvä, läpinäkymätön ja automaattinen tausta palvelevat eri asetteluvaatimuksia; valitse PNG tai WebP, kun alfakanavaa tarvitaan. Läpinäkyvä esine voidaan sijoittaa erilliseen sommitelmaan, ja läpinäkymätön näkymä sisältää oman taustansa. Säilytä valittu tulostiedosto sen sijaan, että käsittelisit sen koodattua toimitusesitystä lopullisena suunnittelutuotoksena.
Tuottajan kuvaviite dokumentoi suoratoiston, jossa voi olla enintään kolme osittaista kuvaa ennen valmistumista. Esikatselu voi näyttää edistymisen, mutta vain lopullinen kuva tulee säilyttää valmiina tuloksena. Anna muokkaussarjassa valittu kuva uudelleen seuraavan konkreettisen ohjeen kanssa. Valmistajan rajapinta tukee myös eräkäsittelyä.
Tarkasta kuvan kirjoitus, asettelulle herkät yksityiskohdat ja lähde-esineen ulkonäkö tehtävänantoa vasten. GPT Image voi edelleen kohdata vaikeuksia tekstin täsmällisessä sijoittelussa, rakenteisissa sommitteluissa ja saman kohteen yhdenmukaisessa toistamisessa eri generoinneissa. Käytä valittua tulosta rajattuun muokkaukseen, kun näkyvä yksityiskohta tarvitsee muutosta, ja pidä sekä muutos- että säilyttämisvaatimukset selkeinä. Hyödyllinen Mini-tulos on valmis kuva määritettyyn luovaan tehtävään, valmisteltuna juuri tämän version tarjoamilla vakiokoko- ja vastaavuusasetuksilla.
POST /v1/images/generationstext, imageimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat openai/gpt-image-1-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-image-1-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-image-1-mini, gpt-image-1-mini
/v1/images
gpt-image-1-miniGPT Image 1 Mini luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä GPT Image 1 -perheessä. Se tukee vakiokokoja, maskeja ja yleisiä kuvamuotoja sekä input_fidelity-asetuksen low-arvoa GPT Image 1 -mallin high-vaihtoehdon sijaan.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
GPT Image 1 Mini on OpenAI:n nimetty Mini-versio GPT Image 1 -perheessä. Se hyväksyy tekstiä ja kuvia ja tuottaa kuvia tuottajan generointi- ja muokkaustyönkulkujen kautta. Käytä sitä tavallisiin luoviin tehtävänantoihin, visuaalisiin konsepteihin ja annetun kuvan muutoksiin, kun Mini-version dokumentoidut asetukset sopivat tehtävään. Käytä tehtävää valmistellessasi Minin vakiokuvakokoja ja input_fidelity-asetuksen low-arvoa.
Kuvaa uuteen kuvaan kohde, näkymä, valo, sommittelu ja tyyli. Osoita muokkaukseen tarvittava muutos ja lähteen elementit, joiden tulee pysyä tunnistettavina. Yksinkertainen kuvitustehtävänanto voi pyytää lähettipyörää oviaukon vieressä, suuria selkeitä muotoja ja hillittyä väripalettia; jatkopyyntö voi vaihtaa taustan säilyttäen valitun sommittelun. Dokumentoiduissa suorissa työnkuluissa kehote voi sisältää enintään 32000 merkkiä ja tulosteita voi olla yhdestä kymmeneen. Tulokset voivat antaa vaihtoehtoja tarkasteluun.
Muokkaus voi käyttää enintään kuuttatoista syötekuvaa. Selitä, mikä kuva antaa pääkohteen, ympäristön tai visuaalisen käsittelyn, sen sijaan että jättäisit roolit epäselviksi. GPT Image 1 Mini tukee input_fidelity-asetukselle vain arvoa low. GPT Image 1 -mallin high-asetus ei ole Minin vaihtoehto. Syötteen vastaavuus eroaa tulosteen renderöintilaadusta: korkealaatuisen tulosteen valinta ei ota käyttöön erilaista lähteen säilyttämistilaa. Pidä säilyttämisvaatimukset selkeinä ja tarkasta olennaiset lähdeyksityiskohdat syntyneestä tuotoksesta.
Maski voi ohjata pyydetyn muutoksen valittuun alueeseen. Lähteellä ja maskilla pitää olla sama muoto ja samat mitat, ja maski tarvitsee alfakanavan; kuvageneroinnin opas määrittää alle 50 MB:n kokovaatimuksen. Useita lähdekuvia käytettäessä maski koskee ensimmäistä. Rajattu tehtävänanto voi muuttaa yhden esineen väriä säilyttäen näkymän yleisen rajauksen. Maski on kehotteeseen perustuva ohje eikä taattu geometrinen raja, joten tarkasta myös viereinen alue tavoitellun muutoksen lisäksi.
Vakiokuvakoot ovat 1024 × 1024, 1536 × 1024 ja 1024 × 1536 pikseliä, ja automaattinen valinta on käytettävissä sitä tukevissa rajapinnoissa. Renderöintilaadun vaihtoehdot ovat low, medium, high ja auto. Ne ovat erillään Minin syötteen vastaavuudesta, joka tukee vain low-arvoa. Myöhempien GPT Image -versioiden mukautetut suuren tarkkuuden mitat sekä xhigh- ja max-tasot eivät kuulu tähän Mini-profiiliin. Valitse käyttökohteeseen sopiva kuvakoko ja luonnokselle tai valmiille tuotokselle sopiva laatutaso.
Tuottaja tukee PNG-, JPEG- ja WebP-tulosteita, joista PNG on oletus. JPEG ja WebP voivat käyttää pakkausta väliltä 0–100. Läpinäkyvä, läpinäkymätön ja automaattinen tausta palvelevat eri asetteluvaatimuksia; valitse PNG tai WebP, kun alfakanavaa tarvitaan. Läpinäkyvä esine voidaan sijoittaa erilliseen sommitelmaan, ja läpinäkymätön näkymä sisältää oman taustansa. Säilytä valittu tulostiedosto sen sijaan, että käsittelisit sen koodattua toimitusesitystä lopullisena suunnittelutuotoksena.
Tuottajan kuvaviite dokumentoi suoratoiston, jossa voi olla enintään kolme osittaista kuvaa ennen valmistumista. Esikatselu voi näyttää edistymisen, mutta vain lopullinen kuva tulee säilyttää valmiina tuloksena. Anna muokkaussarjassa valittu kuva uudelleen seuraavan konkreettisen ohjeen kanssa. Valmistajan rajapinta tukee myös eräkäsittelyä.
Tarkasta kuvan kirjoitus, asettelulle herkät yksityiskohdat ja lähde-esineen ulkonäkö tehtävänantoa vasten. GPT Image voi edelleen kohdata vaikeuksia tekstin täsmällisessä sijoittelussa, rakenteisissa sommitteluissa ja saman kohteen yhdenmukaisessa toistamisessa eri generoinneissa. Käytä valittua tulosta rajattuun muokkaukseen, kun näkyvä yksityiskohta tarvitsee muutosta, ja pidä sekä muutos- että säilyttämisvaatimukset selkeinä. Hyödyllinen Mini-tulos on valmis kuva määritettyyn luovaan tehtävään, valmisteltuna juuri tämän version tarjoamilla vakiokoko- ja vastaavuusasetuksilla.
POST /v1/images/generationstextimage| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat gpt-image-1-mini | 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.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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-1-mini', '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 Ultra openai/gpt-image-1-mini, gpt-image-1-mini
/v1/images