---
title: "Nano Banana 2.1 API: mallitunnus, hinnat, resoluutiot ja rajat"
description: "Nano Banana 2.1 API -faktat Googlen dokumenteista: mallitunnus gemini-nano-banana-2.1, pyyntökentät, 1K/2K/4K-koot, 14 viitekuvaa ja hinnat."
robots: "index, follow"
canonical: "https://potto.ai/fi/blog/nano-banana-2-1-api"
markdown: "https://potto.ai/fi/blog/nano-banana-2-1-api.md"
author: "Potto AI Team"
category: "AI images"
datePublished: "2026-10-11T00:00:00.000Z"
language: "fi"
dateModified: "2026-10-12T10:46:16.519Z"
---

# Nano Banana 2.1 API: mallitunnus, hinnat, resoluutiot ja rajat

Nano Banana 2.1 API on Googlen Gemini API -malli `gemini-nano-banana-2.1`, tehokas kuvagenerointi- ja keskusteleva muokkausmalli, jota kutsut tekstikehotteella ja halutessasi viitekuvilla. Googlen [Nano Banana 2.1 -mallisivun](https://ai.google.dev/gemini-api/docs/models/gemini-nano-banana-2.1) mukaan se palauttaa 1K- (oletus), 2K- tai 4K-kuvia, hyväksyy enintään 14 viitekuvaa (enintään 10 objektia ja enintään 4 hahmoa), ja ajattelutaso on konfiguroitavissa. Googlen vakiohinta on $0.0336 / 1K kuva, $0.0504 / 2K kuva ja $0.113 / 4K kuva, ja eräajot hinnoitellaan puoleen tästä.

Tämä opas kokoaa integraatiotiedot yhteen paikkaan: mallitunnus, mitä päätepistettä kutsutaan, olennaiset pyyntökentät, tulostekoot, viitekuvapaikat, hinnoittelu, pyyntörajat ja eräajot. Kaikki luvut tulevat Googlen virallisesta dokumentaatiosta, luettuna 2026-10-10. Hinnat ja rajat muuttuvat, joten varmista ne Googlen sivuilta ennen budjetointia tai käynnistystä.

Potto ei tarjoa julkista API:a. Jos haluat kutsua mallia omasta koodistasi, käytä suoraan Googlen Gemini API:a. Jos haluat vain kuvat, Potton verkkotyökalun [Nano Banana 2.1](/fi/nano-banana-2-1) -sivulla voit luoda ja muokata samalla mallilla kirjoittamatta pyyntöä.

## Nano Banana 2.1 API yhdellä silmäyksellä

| Kohde | Mitä Googlen dokumentaatio sanoo |
| --- | --- |
| Mallitunnus | `gemini-nano-banana-2.1` (vakaa versio käyttää samaa mallitunnusta) |
| Syöte | Teksti, kuva, video ja PDF |
| Tuloste | Kuva ja teksti |
| Tulosteen resoluutiot | 1K (oletus), 2K, 4K; 512px ei ole tuettu versiossa 2.1 |
| Viitekuvat | Enintään 14 yhteensä: enintään 10 kohdetta ja enintään 4 hahmoa |
| Ajattelutasot | `minimal`, `medium` (oletus), `high` |
| Grounding | Google Web ja Image Search |
| Batch API | Tuettu |
| Ei tuettu | Function calling, structured outputs, caching, code execution, URL context, Maps grounding, Live API, äänen generointi |
| Ilmainen taso | Ei saatavilla |
| Kuvan vakiohinta | $0.0336 (1K), $0.0504 (2K), $0.113 (4K) |
| Kuvan hinta eräajossa | $0.0168 (1K), $0.0252 (2K), $0.0567 (4K) |

Lähteet: Googlen mallisivu (viimeksi päivitetty 2026-10-06 UTC) ja hinnoittelusivu, luettu 2026-10-10.

![Nano Banana 2.1 API -pyynnön kulku: kehote ja viitekuvat menevät Gemini API -mallille ja kuva palautuu](https://potto.ai/blog/nano-banana-2-1-api/fi/nano-banana-2-1-api-request-flow.webp#1200x675)

## Mikä on Nano Banana 2.1 API?

”Nano Banana” on suosittu nimi Googlen Gemini-perheen kuvagenerointi- ja muokkausmalleille, ja ”Nano Banana 2.1 API” on yksinkertaisesti tapa päästä käsiksi yhteen niistä koodista käsin. Erillistä tuotetta ei ole, johon pitäisi ilmoittautua: käytät Gemini API -avainta ja nimeät mallitunnuksen pyynnössä. Googlen kuvagenerointiopas listaa viisi mallia Nano Banana -nimen alla, kullakin oma tunnuksensa:

| Nimi | Mallitunnus |
| --- | --- |
| Nano Banana 2.1 | `gemini-nano-banana-2.1` |
| Nano Banana 2 Lite | `gemini-3.1-flash-lite-image` |
| Nano Banana 2 | `gemini-3.1-flash-image` |
| Nano Banana Pro | `gemini-3-pro-image` |
| Nano Banana (alkuperäinen) | `gemini-2.5-flash-image` |

Googlen oppaan mukaan 2.1 on ensisijainen korkean hyötysuhteen työjuhtamalli kuvagenerointiin ja keskustelevaan muokkaukseen, ja sitä suositellaan kaikkiin uusiin projekteihin. Jos haluat vertailun Pro-malliin, lue [Nano Banana 2.1 vs Nano Banana Pro](/fi/blog/nano-banana-2-1-vs-nano-banana-pro) -opas; tämä artikkeli keskittyy 2.1-integraatioon.

Google listaa paremman visuaalisen laadun ja realistisuuden 1K-, 2K- ja 4K-resoluutioissa, korjatut laatoitusartefaktit leveillä ja panoraamakuvasuhteilla (1:4, 4:1, 1:8 ja 8:1) 2K- ja 4K-resoluutioissa, parantuneen tekstin renderöinnin ja infografiikan asettelun tarkkuuden sekä grounding Google Web and Image Search -haun avulla. Dokumentaatio ei julkaise benchmark-tuloksia, joten testaa omat kehotteesi ennen kuin sitoutat putken malliin.

## Mitä päätepistettä kannattaa kutsua?

Kutsu Interactions APIa. Googlen kuvagenerointiopas käyttää sitä jokaisessa Nano Banana 2.1 API -esimerkissä: `POST` osoitteeseen `https://generativelanguage.googleapis.com/v1beta/interactions` ja avain `x-goog-api-key`-otsikossa. Googlen Interactions API -yleiskatsauksen mukaan se on kesäkuusta 2026 alkaen yleisesti saatavilla ja suositeltu kaikkiin uusiin projekteihin, ja kaikki uudet mallit, työkalut ja agenttiominaisuudet julkaistaan siellä. Vanhemmasta `generateContent`-API:sta sanotaan, että se on vanhentunut, mutta sitä tuetaan edelleen täysin.

SDK-kutsut (`client.interactions.create`) edellyttävät `google-genai`- tai `@google/genai`-versiota 2.3.0 tai uudempaa. Yleiskatsauksessa mainitaan myös, että Batch API, eksplisiittinen välimuisti ja mukautetut turva-asetukset eivät ole vielä saatavilla Interactionsissa, joten eräajohinnoittelu tarkoittaa `generateContent`-rajapinnan käyttöä, kuten eräajo-osio selittää.

## Lähetä ensimmäinen Nano Banana 2.1 API -pyyntösi

Pienin pyyntö nimeää mallin ja välittää kehotteen tekstielementtinä. Googlen opas näyttää tämän REST-kutsun:

```bash
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {"type": "text", "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"}
    ]
  }'
```

Tuloksen muodon valitsemiseksi lisää `response_format`-objekti. Samat kentät näkyvät Googlen Python-esimerkissä, jossa tuloste luetaan kohteesta `interaction.output_image`:

```bash
-d '{
    "model": "gemini-nano-banana-2.1",
    "input": [{"type": "text", "text": "A cedar bottle on a linen cloth, soft window light"}],
    "response_format": {
      "type": "image",
      "mime_type": "image/jpeg",
      "aspect_ratio": "16:9",
      "image_size": "2K"
    },
    "generation_config": {"thinking_level": "medium"}
  }'
```

Kentät selkokielellä:

| Kenttä | Mitä se tekee |
| --- | --- |
| `input` | Kehote `{"type": "text", "text": ...}` -elementteinä sekä `{"type": "image", ...}` -elementit viitekuville |
| `response_format.mime_type` | `image/jpeg` tai `image/png` Googlen esimerkeissä |
| `response_format.aspect_ratio` | Esimerkiksi `1:1`, `5:4` tai `16:9` Googlen esimerkeissä |
| `response_format.image_size` | `1K`, `2K` tai `4K`, isolla K-kirjaimella |
| `generation_config.thinking_level` | `minimal`, `medium` tai `high` |
| `previous_interaction_id` | Jatkaa aiempaa interaktiota usean kierroksen muokkaukseen |

SDK-esimerkeissä kuva saapuu base64-koodattuna kohteessa `interaction.output_image.data`, ja Python-esimerkki purkaa sen komennolla `base64.b64decode` ennen tiedoston kirjoittamista. Interaktio sisältää myös `steps`, joka voi sisältää ajatusvaiheita ja lopullisen `model_output`. Googlen REST-esimerkki ei tulosta vastauksen runkoa, joten tarkastele todellista vastausta ennen kuin kirjoitat jäsentimen raakaan JSONiin.

## Nano Banana 2.1 API:n tulostekoot: 1K, 2K ja 4K

Nano Banana 2.1 tuottaa kolme tulostekokoa: 1K, 2K ja 4K, ja 1K on oletusarvo, jos et aseta `image_size`-parametria. Googlen hinnoittelusivu luettelee kuvatokenit, jotka kukin koko kuluttaa: 1,120 1K-kuvalle, 1,680 2K:lle ja 3,780 4K:lle.

![Nano Banana 2.1:n tulostekoot 1K, 2K ja 4K esitettynä kolmena sisäkkäisenä kehyksenä](https://potto.ai/blog/nano-banana-2-1-api/fi/nano-banana-2-1-output-sizes.webp#1200x675)

Kuvagenerointioppaan säännöt, jotka aiheuttavat todellisia virheitä:

- **Vain iso K.** Pienet arvot, kuten `1k`, hylätään.
- **Ei 512px 2.1:ssä.** Pienempi 512px (0.5K) -koko kuuluu Gemini 3.1 Flash Imagelle, ei Nano Banana 2.1:lle.
- **Kuvasuhteet.** 2.1:n esimerkeissä käytetään suhteita `1:1`, `5:4` ja `16:9`. Googlen mallisivu nimeää `1:4`, `4:1`, `1:8` ja `8:1` leveiksi ja panoraamamaisiksi suhteiksi, joissa laatoitusartefaktit korjattiin 2K:lla ja 4K:lla. Tätä opasta varten luetut sivut eivät tulosta täydellistä luetteloa 2.1:n kuvasuhteista, joten testaa tarvitsemasi tarkka kuvasuhde ennen kuin rakennat asettelun sen varaan.
- **Pikselimitat.** Googlen opas ei julkaise pikselitaulukkoa 2.1:lle, joten mittaa palautettu tiedosto, jos asettelusi tarvitsee kiinteät mitat.

Jokainen Googlen työkaluilla luotu kuva sisältää SynthID-vesileiman oppaan mukaan. Varaudu siihen, jos jälkikäsittelet tai rajaat tulosteita.

Säädä kehotteet 1K:lla, koska suurempi koko ei korjaa heikkoa sommittelua tai väärin kirjoitettua sanaa. Jos sinulla on jo onnistunut kuva ja tarvitset vain enemmän pikseleitä, [image upscaler](/fi/image-upscaler) suurentaa sen ilman uutta generointia.

## Viitekuvat: jopa 14 pyyntöä kohden

Nano Banana 2.1 hyväksyy jopa 14 viitekuvaa yhdessä pyynnössä, ja määrä on kokonaismäärä eri tyyppien kesken. Googlen ohje jakaa paikat malleittain:

| Viitetyyppi | Nano Banana 2.1 |
| --- | --- |
| Objektit (korkea tarkkuus lopullisessa kuvassa) | Enintään 10 |
| Hahmot (johdonmukaisuus kuvien välillä) | Enintään 4 |
| Yhteensä | Enintään 14 |

Jokainen viite on yksi lisäkohde `input`-listassa. Googlen Python-esimerkissä kuvakohteella on `"type": "image"`, kuvan tavut base64-muodossa `data`-kentässä ja `mime_type`, kuten `image/png`, sijoitettuna sen tekstikohteen viereen, joka sisältää kehotteen.

![Nano Banana 2.1 hyväksyy jopa 14 viitekuvaa, jotka näytetään objektien ja hahmojen viitteiden ruudukkona](https://potto.ai/blog/nano-banana-2-1-api/fi/nano-banana-2-1-reference-images.webp#1200x675)

Käytännön vinkit paikkojen hyödyntämiseen: anna jokaiselle kuvalle yksi tehtävä ja kerro siitä kehotteessa (ensimmäinen kuva on tuotteen muoto, toinen väripaletti); käytä samaa hahmokuvaa toistuvan kasvon kohdalla; ja lisää viitteitä yksi kerrallaan, sillä useammat viitteet eivät takaa, että jokainen yksityiskohta säilyy.

## Ajattelu- ja grounding-asetukset

Nano Banana 2.1 API tukee kolmea ajattelutasoa, jotka asetetaan `generation_config.thinking_level` -asetuksella: `minimal`, `medium` (oletus) ja `high`. Googlen ohjeen mukaan ajattelu on oletuksena päällä Gemini 3 -kuvamalleissa, eikä sitä voi poistaa käytöstä API:n kautta; malli voi tuottaa enintään kaksi väliaikaista ajatuskuvaa ja ajattelutokenit laskutetaan oletuksena. Muut Nano Banana -mallit ilmoittavat eri tasoja (Nano Banana 2 ilmoittaa `minimal` ja `high`), joten älä kopioi asetusta mallista toiseen.

Groundingin avulla malli voi käyttää Google Searchia aikaherkkiin aiheisiin. Interaktiot-API:ssa lisäät `tools`-kohtaan `google_search`, ja `search_types`-arvo `["web_search", "image_search"]` pyytää verkko- ja kuvatuloksia; Image Search -grounding on saatavilla vain malleissa Nano Banana 2.1 ja Gemini 3.1 Flash Image. Google huomauttaa, että Image Search -tulokset on näytettävä niiden `search_suggestions`-tietojen kanssa, joten rakenna kyseinen näyttö käyttöliittymääsi.

Grounding laskutetaan erikseen: Googlen hinnoittelusivulla annetaan 5,000 ilmaista hakupyyntöä kuukaudessa, jaettuna Gemini 3:n ja uudempien mallien kesken, minkä jälkeen $14 / 1,000 pyyntöä. Tarkista kaikki nimet, luvut ja päivämäärät grounding-kuvasta ennen julkaisua.

## Monivaiheinen muokkaus previous_interaction_id-parametrilla

Jos haluat muuttaa kuvaa, jonka olet jo luonut, lähetä toinen pyyntö, jossa `previous_interaction_id` on asetettu ensimmäisen interaktion `id`-tunnukseen, ja kuvaile vain muutos. Googlen esimerkissä infografiikan teksti käännetään espanjaksi ja muut elementit jätetään ennalleen. Interactions API -yleiskatsauksen mukaan `generation_config`, `tools` ja `system_instruction` ovat interaktiokohtaisia, joten ne on asetettava uudelleen joka kierroksella, ja `store`-asetuksen asettaminen arvoon `false` estää `previous_interaction_id`-parametrin käytön. Muokkauksissa, joissa haluat maalata alueen päälle käsin, [AI photo editor](/fi/ai-image-editor) on helpompi kuin sen kuvaileminen sanoilla.

## Nano Banana 2.1 API:n hinnoittelu

Google laskuttaa Nano Banana 2.1:tä tokeneilla, ja kuvatulosteella on oma hintansa. Tämä on standardi (maksullinen palvelutaso) -hinnasto Gemini API:n hinnoittelusivulta, luettu 2026-10-10:

| Kohde | Vakio | Eräajo |
| --- | --- | --- |
| Syöte (teksti, kuva, video) | $1.50 / 1M tokenia | $0.75 / 1M tokenia |
| Tulosteksti ja ajattelu | $7.50 / 1M tokenia | $3.75 / 1M tokenia |
| Tulostekuvat | $30.00 / 1M kuvatokenia | $15.00 / 1M kuvatokenia |
| Yksi 1K-kuva | $0.0336 | $0.0168 |
| Yksi 2K-kuva | $0.0504 | $0.0252 |
| Yksi 4K-kuva | $0.113 | $0.0567 |
| Grounding Google-haulla | 5,000 ilmaista pyyntöä kuukaudessa, sen jälkeen $14 / 1,000 | Ei erikseen listattu |

Kuvakohtaiset hinnat ovat kuvatokenhinta, jota sovelletaan edellisen osion tokenmääriin: 1,120 tokenia hintaan $30 miljoonaa kohti on $0.0336. Ilmainen taso on merkitty tälle mallille merkinnällä, ettei se ole saatavilla, joten jokainen kutsu vaatii laskutettavan projektin.

Mittakaavan havainnollistamiseksi, käyttäen Googlen hintoja pelkälle kuvatulosteelle: 1,000 kuvaa maksaa $33.60 1K-koossa, $50.40 2K-koossa ja $113.00 4K-koossa, tai $25.20 2K-koossa eräajona. Syötetokenit (kehotteesi ja mahdolliset viitekuvat), ajattelutokenit ja grounding-pyynnöt laskutetaan päälle, joten mittaa esimerkkiajo ennen kuin sitoudut budjettiin.

## Pyyntörajat ja kiintiöt

Googlen pyyntörajasivu ei ilmoita numeroa Nano Banana 2.1 API:lle. Se selittää, miten rajat toimivat, ja ohjaa sinut Google AI Studioon katsomaan lukuja, jotka koskevat projektiasi ja palvelutasoasi.

Mitä sivulla kuitenkin sanotaan:

- **Ulottuvuudet.** Pyynnöt minuutissa (RPM), syöte-tokenit minuutissa (TPM) ja pyynnöt päivässä (RPD); kuvia tuottavilla malleilla on myös kuvia minuutissa (IPM). Minkä tahansa yhden ulottuvuuden ylittäminen aiheuttaa virheen.
- **Laajuus.** Rajat koskevat projektia, eivät API-avainta, ja päivittäiset kiintiöt nollautuvat keskiyöllä Tyynenmeren aikaa.
- **Palvelutasot.** Ilmainen taso vaatii aktiivisen projektin, Tier 1 linkitetyn laskutustilin, Tier 2 $100 kumulatiivista maksettua kulutusta plus 3 päivää ja Tier 3 $1,000 plus 30 päivää. Tason korotukset ovat automaattisia.
- **Kulukatot.** Kulutukseen perustuvat rajat koskevat liukuvaa 10 minuutin ikkunaa, ja yhden saavuttaminen palauttaa `429 RESOURCE_EXHAUSTED` -virheen.

Silmukka, joka lähettää monta rinnakkaista pyyntöä, voi osua 429-virheeseen kauan ennen kuin päivittäinen kiintiö on käytetty, joten lisää uudelleenyritys ja backoff, rajaa samanaikaisuus ja lähetä suuret offline-työt Batch API:n kautta.

Mallin sivulla luetellaan myös 131,072 syöte-tokenia ja 32,768 tuloste-tokenia, eikä se tue Flex- tai Priority-inferenssiä.

## Batch API ja Nano Banana 2.1

Mallisivu luettelee Batch API:n tuetuksi, ja Googlen hinnoittelusivu hinnoittelee eräajokuvatulosteen puoleen vakiohinnasta: $0.0168 per 1K kuva, $0.0252 per 2K kuva ja $0.0567 per 4K kuva. Batch API -opas asettaa tavoiteläpimenoajaksi 24 tuntia, vaikka useimmissa tapauksissa se on paljon lyhyempi. Vaihtokaupassa odotusaika vaihdetaan hintaan ja korkeampiin pyyntörajoihin, mikä sopii luettelopäivityksiin, kehote-testeihin ja massamuunnelmiin pikemminkin kuin käyttöliittymään, jossa henkilö odottaa.

Yksityiskohdat Batch API -oppaasta: inline-pyyntöjen on oltava yhteensä alle 20 MB, kun taas suuremmat työt käyttävät JSONL-tiedostoa (enintään 2 GB), jossa on yksi pyyntö per rivi ja määrittelemäsi `key`. Työt etenevät tilojen `JOB_STATE_PENDING`, `JOB_STATE_RUNNING` ja `JOB_STATE_SUCCEEDED` kautta tai päättyvät epäonnistuneina, peruutettuina tai `JOB_STATE_EXPIRED`; yli 48 tuntia vireillä tai käynnissä oleva työ vanhenee. Pyyntörajat-sivulla luetellaan 100 samanaikaista eräajopyyntöä ja 20 GB tiedostotallennustilaa sekä palvelutasokohtaiset jonossa olevien tokenien rajat.

Yksi kompastuskivi: oppaassa sanotaan, että eräajo on saatavilla vain `generateContent`-API:n kanssa, ja sen kuviesimerkeissä käytetään `responseModalities`-asetusta `["TEXT", "IMAGE"]` eri Nano Banana -mallitunnuksella. Siinä ei ole esimerkkiä `gemini-nano-banana-2.1`:stä, joten aja pieni testieräajo tällä mallitunnuksella ennen kuin lähetät tuhansia pyyntöjä. Käytännössä interaktiivinen muokkaus toimii Interactions API:n kautta ja massallinen offline-tuotanto `generateContent`-eräajoina.

## Siirtyminen aiemmista malleista Nano Banana 2.1:een

Googlen hinnoittelusivu merkitsee alkuperäisen Nano Bananan, `gemini-2.5-flash-image`, vanhentuneeksi, ja sen käytöstä poistamisen päivämäärä on 2. lokakuuta 2026. Kuvagenerointiopas suosittelee Nano Banana 2.1:tä uusiin projekteihin.

Tarkista nämä erot, kun vaihdat mallitunnuksen Nano Banana 2.1 API:een. 2.1 luettelee ajattelutasot `minimal`, `medium` ja `high`, kun taas 3.1 Flash Image luettelee `minimal` ja `high`. 512px:n kuvakoko on 3.1 Flash Imagessa mutta ei 2.1:ssä, joten pyydä 1K ja muuta koko omalla puolellasi. Image Search -grounding toimii 2.1:ssä ja 3.1 Flash Imagessa, eikä Flash Litessä ole search-groundingia. 2.1 ei tue funktiokutsuja tai jäsenneltyjä tulosteita, joten siirrä kaikki JSON:ia tuottavat vaiheet tekstimalliin. Laske kustannusarviosi uudelleen yllä olevilla 2.1-hinnoilla, aja sitten tallennetut kehotteesi uuden mallin läpi ja vertaa tuloksia vanhoihin, koska mallin vaihtaminen muuttaa tyyliä ja tekstin renderöintiä myös identtisillä kehotteilla.

## Käytä Nano Banana 2.1:tä ilman API:a

Jos tavoitteesi on kuva eikä integraatio, selain on yksinkertaisempi. Poton [AI-kuvageneraattori](/fi/ai-image-generator) tarjoaa Nano Banana 2.1:n HD-, 2K- ja 4K-tulosteella, jopa 10 viitekuvaa sekä PNG- tai JPEG-tiedostot. Koska Potolla ei ole julkista API:a, tämä on vain verkkotyönkulku.

Potto hinnoittelee kuvat krediiteissä, jotka näytetään Generate-painikkeessa ennen vahvistusta. Nano Banana 2.1 maksaa 12 krediittiä kuvaa kohden HD-laadulla, 17 2K:lla ja 38 4K:lla, ja epäonnistunut pyyntö vapauttaa krediitit. Krediitit ovat Poton oma yksikkö, ei muunnos Googlen dollarihinnoista, joten älä vertaa niitä kuin ne olisivat sama valuutta. Sivulla [hinnoittelu](/fi/pricing) luetellaan paketit, ja sivulla [tekoälymallit](/fi/ai-models) verrataan jokaista luojan kuvamallia, mukaan lukien Nano Banana ja Nano Banana Pro.

Työnkulut vastaavat API:a: [tekstistä kuvaksi](/fi/text-to-image) on pyyntö, jossa on vain tekstiosio, [kuvasta kuvaksi](/fi/image-to-image) lisää oman kuvasi kuten kuviosion `input`-kohdassa, AI-hahmogeneraattori kohdistaa toistuviin hahmoihin, ja kuvapohjat antavat sinulle muokattavan ohjeen.

![Nano Banana 2.1 API tai verkkotyökalu: koodireitti ja selainreitti, jotka molemmat johtavat samanlaiseen kuvaan](https://potto.ai/blog/nano-banana-2-1-api/fi/nano-banana-2-1-api-vs-web-generator.webp#1200x675)

## API vai verkkotyökalu: kumpaa kannattaa käyttää?

Käytä Gemini API:a, kun kuvia tuotetaan omassa tuotteessasi tai aikataulun mukaan: verkkokauppa, joka tuottaa muunnelman jokaiselle tuotelistaukselle, yön yli ajettava eräajo erähinnoilla tai sovellus, jossa käyttäjät kirjoittavat kehotteen. Hallitset avaimet, uudelleenyritykset, tallennuksen ja laskun, ja saat Googlen täyden parametrivalikoiman.

Käytä verkkotyökalua, kun kuvia tekee ihminen: kampanjajuliste, tuotekuvat, maskotti esitykseen. Ei hallittavaa avainta eikä jäsennettävää vastausta, ja hinta näkyy ennen jokaista generointia. Voit myös kokeilla kehotetta selaimessa ja siirtää toimivimman sanamuodon myöhemmin API-kutsuun.

## Usein kysytyt kysymykset

### Mikä on Nano Banana 2.1 API?

Nano Banana 2.1 API on tapa kutsua Googlen `gemini-nano-banana-2.1` -kuvamallia Gemini API:n kautta. Se ottaa vastaan teksti-, kuva-, video- tai PDF-syötettä, palauttaa kuvia ja tekstiä sekä tukee 1K, 2K ja 4K -tulostetta, jopa 14 viitekuvaa, konfiguroitavaa ajattelua ja Google Search -groundingia. Se ei ole erillinen tuote: käytät Gemini API -avainta ja nimeät mallitunnuksen pyynnössäsi.

### Mikä on Nano Banana 2.1 -mallitunnus?

Mallitunnus on `gemini-nano-banana-2.1`. Googlen mallisivun mukaan vakaa versio käyttää samaa tunnusta, joten versiopäätettä ei tarvita. Muilla Nano Banana -malleilla on omat mallitunnuksensa, kuten `gemini-3.1-flash-image` mallille Nano Banana 2, joten tarkista mallitunnus aina, kun vaihdat mallia.

### Paljonko Nano Banana 2.1 API maksaa?

Vakiohinnoilla Google veloittaa $0.0336 per 1K-kuva, $0.0504 per 2K-kuva ja $0.113 per 4K-kuva sekä token-maksut syötteestä ja ajattelusta. Eräajot maksavat puolet: $0.0168, $0.0252 ja $0.0567. Nämä luvut ovat Googlen Gemini API -hinnoittelusivulta 2026-10-10 luettuna, eikä ilmainen taso ole tälle mallille saatavilla.

### Kuinka monta viitekuvaa Nano Banana 2.1 voi käyttää?

Jopa 14 yhdessä pyynnössä: enintään 10 objektikuvaa ja enintään 4 hahmokuvaa. Google laskee kokonaismäärän kaikkien tyyppien yli, joten pyyntö ei voi ylittää 14:ää, vaikka molemmat rajat olisi käytössä. Anna jokaiselle viitekuvalle yksi tehtävä kehotteessa ja tarkista tuloksesta yksityiskohdat, joista välität.

### Tarjoaako Potto Nano Banana 2.1 API:n?

Ei. Potto ei tarjoa julkista API:a. Voit käyttää Nano Banana 2.1 -mallia Poton verkkotyökalussa: 12 krediittiä kuvaa kohden HD-laadulla, 17 krediittiä 2K:lla ja 38 krediittiä 4K:lla. Kehittäjien, jotka haluavat kutsua mallia koodista, kannattaa käyttää Googlen Gemini API:a mallitunnuksella `gemini-nano-banana-2.1`.

### Mitkä ovat Nano Banana 2.1 API:n pyyntörajat?

Google ei julkaise numeroa tälle mallille pyyntörajasivullaan. Rajat mitataan pyyntöinä minuutissa, syötetokeneina minuutissa, pyyntöinä päivässä ja kuvamalleilla kuvina minuutissa, ja ne ovat projektikohtaisia ja riippuvat käyttämästäsi palvelutasosta. Avaa pyyntörajojen näkymä Google AI Studiossa nähdäksesi luvut, jotka koskevat tiliäsi.

### Voiko Batch API:a käyttää Nano Banana 2.1:n kanssa?

Kyllä. Google listaa Batch API:n tuetuksi mallisivullaan ja hinnoittelee eräajokuvat puoleen vakiohinnasta 24 tunnin tavoitellulla käsittelyajalla. Eräajo on saatavilla vain `generateContent` API:n kanssa, ei Interactions API:n kanssa, ja Googlen eräajokuvien esimerkeissä käytetään eri Nano Banana -mallitunnusta, joten testaa ensin pieni erä mallilla `gemini-nano-banana-2.1`.

## Lähteet

Kaikki lähteet on luettu 2026-10-10. Hinnat, rajat ja mallitiedot ovat Googlen ilmoittamia ja voivat muuttua.

- [Gemini Nano Banana 2.1 -mallisivu](https://ai.google.dev/gemini-api/docs/models/gemini-nano-banana-2.1), Google AI for Developers.
- [Kuvien luonti Geminillä (Nano Banana)](https://ai.google.dev/gemini-api/docs/image-generation), Google AI for Developers.
- [Gemini Developer API -hinnoittelu](https://ai.google.dev/gemini-api/docs/pricing), Google AI for Developers.
- [Gemini API -pyyntörajat](https://ai.google.dev/gemini-api/docs/rate-limits), Google AI for Developers.
- [Batch API](https://ai.google.dev/gemini-api/docs/batch-api), Google AI for Developers.
- [Interactions API -yleiskatsaus](https://ai.google.dev/gemini-api/docs/interactions), Google AI for Developers.