Source: https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/ Canonical: https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/ Language: fi # Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) [Markdown](https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/index.md) · [JSON](https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/facts.json) ## [Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)](https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/) Nano Banana 2 (Gemini 3.1 Flash Image Preview) luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä. Sen dokumentoituja vahvuuksia ovat aiheen säilyminen yhtenäisenä, kuvan sisäinen teksti ja lokalisointi, keskustelupohjaiset muutokset sekä sommittelun, kuvasuhteen ja resoluution luova ohjaus. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/#method-0) - [**Ailoot Ultra · Kuvat** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/fi/google-gemini-3-1-flash-image-preview/#method-2) Tietoa mallista Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle. Nano Banana 2 on Googlen Gemini 3.1 Flash Image -malli, jolla tuotetaan kuvia ja muokataan niitä keskustelun avulla. Tässä mallikuvauksessa säilytetään täsmällinen Preview-mallinimi. Kirjallinen kuvaus voi määrittää uuden kuvan, ja syötekuva voi määrittää muokattavan kohteen, ulkoasun tai sommittelun. Tulos voi sisältää kuvan ja oheistekstiä. Googlen julkaisuaineisto korostaa maailmaa koskevaa tietämystä, tekstin esittämistä kuvissa ja kohteen säilymistä yhtenäisenä sekä mahdollisuutta tarkentaa kohtausta toisiinsa liittyvien keskusteluvuorojen avulla. Kun kuvia luodaan tietolähteiden pohjalta, malli voi dokumentaation mukaan hyödyntää verkko- ja kuvahausta saatuja tietoja. Tämä tukee esimerkiksi tietystä paikasta innoituksensa saavan kuvituksen tai annettuihin tietoihin perustuvan kaavion laatimista. Määritä, mitkä lähteiden sisältämät tosiasiat kuvassa on esitettävä, ja erota ne taiteellisista valinnoista. Hakutietojen hyödyntäminen kuvan tuottamisessa ei tarkoita, että jokainen lopullisen kuvan yksityiskohta olisi varmennettu tieto. Jos tuotteen, maamerkin tai kaavion esityksen on oltava tarkka, toimita luotettava viiteaineisto ja vertaa tulosta siihen. Julkaisuaineistossa kerrotaan parannuksista kuviin sisältyvän tekstin esittämiseen ja lokalisointiin. Kun teet julistetta, infografiikkaa tai markkinointimateriaalin luonnosta, anna jokaisen tekstielementin täsmällinen sanamuoto, kieli ja tehtävä. Päätä ensin tekstin sanamuoto ja pyydä sitten sen sisältävä kuva kuvaoppaan suosituksen mukaisesti. Selitä lukujärjestys ja eri elementtien keskinäiset painotukset, jotta otsikko, kuvateksti ja kaavion merkintä eivät sekoitu toisiinsa. Tarkista oikeinkirjoitus, välimerkit ja merkinnän yhteys kuvattuun elementtiin ennen kuvan käyttämistä julkaisussa. Kuvan luomista voi ohjata muun muassa kuvasuhteella ja resoluutiolla. Julkaisu tuo 1K-, 2K- ja 4K-vaihtoehtojen rinnalle 512 pikselin kuvakoon ja lisää kuvasuhteet 4:1, 1:4, 8:1 ja 1:8. Kehittäjäoppaassa päättelyn oletustasoksi ilmoitetaan minimal ja vaativampien sommittelujen vaihtoehdoksi high. Valitse käyttötarkoitus ennen sommittelua: pystysuuntainen tarinajulkaisu, leveä banneri ja pienikokoinen kaavio tarvitsevat eri tavoin tilaa kohteelle ja mahdolliselle tekstille. Nämä asetukset kuvaavat kehittäjän tämän mallisarjan kuvantuotantoprosessia, eivät olemassa olevan valmiin aineiston automaattista koon muuttamista. Jotta kohde säilyisi yhtenäisenä, nimeä kunkin viitekuvan tehtävä: tuotteen ulkoasu, hahmon identiteetti, tausta tai visuaalinen tyyli. Kerro ensin, mitkä yksityiskohdat on säilytettävä, ja nimeä sitten muutettavat elementit. Alkuperäisessä tehtävässä voidaan esimerkiksi sijoittaa annettu tuotevalokuva uuteen kohtaukseen niin, että tuotteen muoto, materiaali ja näkyvät bränditunnukset säilyvät. Säilytä kuvitetussa sarjassa samat viitekuvat ja määritä, mitkä yksityiskohdat vaihtelevat kohtauksittain. Viitekuvien määrän lisääminen ei korvaa selkeää ohjetta siitä, mitä kukin kuva tuo tehtävään. Keskustelupohjainen muokkaus sopii tietyn muutoksen tekemiseen. Pyydä muuttamaan yhtä objektia, taustaa tai valaistusta ja säilyttämään hyväksytty sommittelu. Mallin kehittäjän oppaassa kuvataan semanttinen maskaus, jossa muokattava alue määritetään sanallisesti. Kun työskentelet usean keskusteluvuoron ajan, säilytä keskustelu ja valitun rajapinnan vaatimat päättelykontekstin metatiedot; Gemini 3 -oppaassa selitetään, että thought signatures -tunnisteet auttavat välittämään tämän kontekstin. Muuttumattomaksi tarkoitetun alueen kuvaus on ohje, jonka toteutuminen on tarkistettava alkuperäistä vasten, ei takuu siitä, että jokainen pikseli säilyy samana. Gemini 3 -kehittäjätaulukossa mainitaan nimenomaisesti gemini-3.1-flash-image-preview, jonka syöteraja on 128K ja tulosteraja 32K. Kun dokumentoit kuvan tuottamisen, säilytä täsmällinen Preview-mallinimi. Käytettävissä olevat viiteaineistoa, tulosta ja resoluutiota koskevat asetukset tulee säilyttää lähdekuvien ja pyynnön yhteydessä, jotta muokkaus voidaan toistaa johdonmukaisesti. Säilytä muokkausta varten samat lähdeviitteet ja määritä täsmällinen visuaalinen muutos niin, että kunkin syötteen hyväksytty tehtävä säilyy. Kuvaoppaassa varoitetaan, ettei pyydetty kuvamäärä aina toteudu, ja kerrotaan tuotettujen kuvien SynthID-merkinnästä. Tarkista kaikki palautetut kuvat ja mahdollinen oheisteksti sen sijaan, että olettaisit tuloksen olevan yksi tietty kuva. Tarkista kohteen identiteetti, objektien määrä, kuvassa olevat sanamuodot, sommittelu ja kuvan vastaavuus viiteaineistoon suunnitellussa näyttökoossa. Kun kohtaus on monimutkainen, määritä sen osat loogisessa järjestyksessä ja kuvaa myönteisin muotoiluin, miltä kuvan tulee näyttää. Hyödyllinen tulos on tarkistettu visuaalinen aineisto, jonka lähdeviitteet ja täsmällinen mallitunniste on säilytetty seuraavaa muokkausta varten. Käytännön tehtävä ### Käytännön tehtävä Tekninen esimerkki englanniksi ``` Create a four-stage growing guide Create a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants. ``` #### Odotettu tulos ``` An image with four distinct growing stages in the specified order and a consistent illustration style. ``` #### Tarkista tulos ``` Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/fi/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) Google /`google/gemini-3.1-flash-image-preview` ### Aloitus Nano Banana 2 (Gemini 3.1 Flash Image Preview) luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä. Sen dokumentoituja vahvuuksia ovat aiheen säilyminen yhtenäisenä, kuvan sisäinen teksti ja lokalisointi, keskustelupohjaiset muutokset sekä sommittelun, kuvasuhteen ja resoluution luova ohjaus. Hyväksytyt syötteet Teksti Tulokset Teksti ### Saatavilla Ailootissa · syötteet & menetelmät **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Syötetyypit `text` Tulostyypit `text` Tulosteen muoto json tai SSE | Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus | | --- | --- | --- | --- | --- | | Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat google/gemini-3.1-flash-image-preview | Oletus— | | Kenttä`messages` | Tyyppi`message[]` | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— | | Kenttä`messages[].role` | Tyyppi`string` | 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` | Tyyppi`string\|content_part[]\|null` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`messages[].tool_calls` | Tyyppi`tool_call[]` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`messages[].tool_call_id` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: role=tool; käytä todella palautettua ID:tä | Oletus— | | Kenttä`messages[].name` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`messages[].reasoning_content` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Palauta todella saatu päättely takaisin mallille, kun kyseinen malli käyttää sitä | Oletus— | | Kenttä`messages[].reasoning_details` | Tyyppi`object\|array` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`max_tokens` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— | | Kenttä`max_completion_tokens` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— | | Kenttä`stream` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat | Oletusfalse | | Kenttä`stream_options.include_usage` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`temperature` | Tyyppi`number` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`top_p` | Tyyppi`number` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`stop` | Tyyppi`string\|string[]` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`tools` | Tyyppi`function_tool[]` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`tools[].type` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat function Riippuu mallista | Oletus— | | Kenttä`tools[].function.name` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: funktiotyökalu annettu | Oletus— | | Kenttä`tools[].function.description` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`tools[].function.parameters` | Tyyppi`JSON_schema` | VaatimusValinnainen | Arvot & rajat | Oletus— | | Kenttä`tool_choice` | Tyyppi`string\|object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`parallel_tool_calls` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`response_format` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`reasoning_effort` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`reasoning` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`service_tier` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`instructions` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Yhteensopivuuskenttä | Oletus— | | Kenttä`functions` | Tyyppi`function[]` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`function_call` | Tyyppi`string\|object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`prompt_cache_options` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— | | Kenttä`modalities` | Tyyppi`string[]` | VaatimusValinnainen | Arvot & rajat text | Oletus— | | Kenttä`provider` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat Ehdot: provider.options hylätään tällä Ultran tekstireitillä | Oletus— | | Kenttä`cache_control.ttl` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: 1h hylätään varsinaisissa kehotevälimuistin kohdissa | Oletus— | Syöteaineistojen yhdistelmät **Teksti** · UTF8-teksti `messages[].content` Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, messages | | Parametri`material_types` | Sopimustext | | Parametri`messages` | Sopimusviestitaulukko role/content-rakenteella | | Parametri`file_material` | Sopimusvarsinainen UTF-8-asiakirja lisätään sellaisenaan tekstinä; tiedoston ID:tä ei päätellä | | Parametri`optional_controls` | Sopimusstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Parametri`control_scope` | Sopimusmallikohtainen; käyttäjän funktiotyökalut eroavat palvelun isännöimistä työkaluista | | Parametri`output_modalities` | Sopimustext | | Parametri`hosted_operations` | Sopimusfalse | | Parametri`multimodal_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. ### Hinnoittelu Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle. Nopea tila Vakiohinta Kun nopea tila on valittu Flex-tila Vakiohinta Kun flex-tila on valittu Päättelyn enimmäisteho Vakiohinta Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä Päättelyn teho · suuri Vakiohinta Kun päättelyn teho on suuri Päättelyn teho · vähimmäistaso Vakiohinta Kun päättelyn teho on vähimmäistasolla Eksplisiittisen välimuistin hinnoittelu Ei käytössä Kun eksplisiittistä välimuistia pyydetään #### Ailoot-hinnat #### Hinnat asetusten mukaan 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.001** / 1K tokenia Tuloste · Tulostokenit **$0.006** / 1K tokenia Syöte · Välimuistin luku **—** / 1K tokenia Syöte · Välimuistiin kirjoitus **—** / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti **—** / 1K tokenia Tuloste · Kuvatulosteen tokenit **$0.12** / 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.001** / 1K tokenia Tuloste · Tulostokenit **$0.006** / 1K tokenia Syöte · Välimuistin luku **—** / 1K tokenia Syöte · Välimuistiin kirjoitus **—** / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti **—** / 1K tokenia | #### Viitehinnaston tiedot 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. google/gemini-3.1-flash-image-preview #### Hinnat asetusten mukaan | Asetukset | Laskutusehdot | Veloitus | | --- | --- | --- | | Asetuksetgoogle/gemini-3.1-flash-image-preview · Oletusasetukset | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syöte **0,001 $** / 1K tokenia Tuloste · Tuloste **0,12 $** / 1K tokenia | google/gemini-3.1-flash-image-preview #### Hinnat asetusten mukaan | Asetukset | Laskutusehdot | Veloitus | | --- | --- | --- | | Asetuksetgoogle/gemini-3.1-flash-image-preview · Oletuskokoonpano | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syöte **0,001 $** / 1K tokenia Tuloste · Tuloste **0,12 $** / 1K tokenia | google/gemini-3.1-flash-image-preview #### Hinnat asetusten mukaan | Asetukset | Laskutusehdot | Veloitus | | --- | --- | --- | | Asetuksetgoogle/gemini-3.1-flash-image-preview · Oletusasetukset | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syöte **0,00 $** kutsua kohti Tuloste · Tuloste **0,16 $** kutsua kohti | google/gemini-3.1-flash-image-preview #### Hinnat asetusten mukaan | Asetukset | Laskutusehdot | Veloitus | | --- | --- | --- | | Asetuksetgoogle/gemini-3.1-flash-image-preview · Oletusasetukset | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syöte **0,00 $** kutsua kohti Tuloste · Tuloste **0,32 $** kutsua kohti | google/gemini-3.1-flash-image-preview #### Hinnat asetusten mukaan | Asetukset | Laskutusehdot | Veloitus | | --- | --- | --- | | Asetuksetgoogle/gemini-3.1-flash-image-preview · Oletusasetukset | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syöte **0,00 $** kutsua kohti Tuloste · Tuloste **0,00 $** kutsua kohti | Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) #### Hinnat asetusten mukaan | Asetukset | Laskutusehdot | Veloitus | | --- | --- | --- | | AsetuksetGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Oletusasetukset | LaskutusehdotOletuskokoonpano | Veloitus Syöte · Syötetokenit **0,001 $** / 1K tokenia Tuloste · Tulostokenit **0,006 $** / 1K tokenia Tuloste · Kuvatuloste **0,12 $** / 1K tokenia Tuloste · Verkkohaku **0,028 $** hakua kohden | 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 →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · OpenAI Chat curlPython SDKPython-suoratoisto ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-3.1-flash-image-preview", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) 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 file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) 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 file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Vastaanota ja tallenna tulokset #### Ailoot Ultra · OpenAI Chat json tai SSE ##### Säilytä kaikki valmistuneet tulokset 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. ##### Jos alkuperäinen vastaus on tarkistettava Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta. Vastauksen kentät | 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 | Virheet ja seuraavat vaiheet | 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öä. | ### Aliakset #### Mallin aliakset **Ailoot Ultra** [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/fi/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) #### Menetelmäpolkujen aliakset `/v1/images` #### Liittyvät kutsujan ID:t [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/fi/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) **Ailoot Ultra · Kuvat** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/fi/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=images) Google /`google/gemini-3.1-flash-image-preview` ### Aloitus Nano Banana 2 (Gemini 3.1 Flash Image Preview) luo ja muokkaa kuvia tekstistä ja visuaalisista viitteistä. Sen dokumentoituja vahvuuksia ovat aiheen säilyminen yhtenäisenä, kuvan sisäinen teksti ja lokalisointi, keskustelupohjaiset muutokset sekä sommittelun, kuvasuhteen ja resoluution luova ohjaus. Hyväksytyt syötteet Teksti · Kuvat Tulokset Kuvat ### Saatavilla Ailootissa · syötteet & menetelmät **Ailoot Ultra · Kuvat** `POST /v1/images/generations` Syötetyypit `text`, `image` Tulostyypit `image` | Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus | | --- | --- | --- | --- | --- | | Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat google/gemini-3.1-flash-image-preview | Oletus— | | Kenttä`prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Vähimmäispituus: 1 | Oletus— | | Kenttä`resolution` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 512, 1K, 2K, 4K | Oletus— | | Kenttä`aspect_ratio` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | Oletus— | | Kenttä`n` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Enimmäismäärä: 1 | Oletus— | | Kenttä`input_references` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 0 Kohteiden enimmäismäärä: 14 | Oletus— | | Kenttä`provider` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat | Oletus— | Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, prompt | | Parametri`material_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}` ### Hinnoittelu ##### Lopullisen veloituksen laskenta 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. Nopea tila Ei määritetty Kun nopea tila on valittu Flex-tila Ei määritetty Kun flex-tila on valittu Päättelyn enimmäisteho Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä #### Arvioidut vertailuhinnat #### Hinnat asetusten mukaan 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.49152** 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 →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · Kuvat curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-3.1-flash-image-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") 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"