Gemini API to sposób, żeby model Google pracował w twoim programie, a nie w oknie czatu. Klucz zdobywasz w Google AI Studio za darmo, darmowy jest też ruch na większości modeli z aktualnej oferty, a płacisz dopiero, gdy chcesz więcej: od 10 centów za milion tokenów wejścia na najtańszej pozycji cennika. Ta ściąga zbiera w jednym miejscu ścieżkę klucza, tabelę cen, limity darmowego konta i najczęstsze błędy. Wszystko z oficjalnej dokumentacji Google, sprawdzonej 13 października 2026.
Termin, który warto znać przed liczeniem czegokolwiek: modele Gemini 3.8 Flash i 3.6 Flash mają ceny promocyjne obowiązujące tylko do 31 grudnia 2026. Od pierwszego stycznia stawki dla 3.8 Flash rosną dokładnie dwa razy, z 0,75 do 1,50 dolara za milion tokenów wejścia. Jeśli budujesz coś na lata, licz koszty od stawek 2027 roku, nie od dzisiejszych.
- Najważniejsze informacje
- Czym różni się darmowe Gemini w aplikacji od darmowego API
- Jak zdobyć klucz API za darmo
- Pierwsze zapytanie: sześć linii Pythona
- Ile kosztuje Gemini API: ceny za milion tokenów
- Limity darmowego planu: co widać bez logowania
- Plan płatny: pięć dolarów na start i trzy poziomy
- Co gdy nie działa: od 429 po wyciek klucza
- Gemini API z Polski: płatność, język, podatki
- Najczęstsze pytania
Najważniejsze informacje
| Co | Szczegóły |
|---|---|
| Klucz API | darmowy, w Google AI Studio (aistudio.google.com/apikey), wymaga konta Google i projektu Cloud |
| Darmowy ruch | tak, na większości modeli; wyjątkiem jest Gemini 3.1 Pro Preview, płatny od pierwszego tokena |
| Najtańsze wejście | 2.5 Flash-Lite: 0,10 USD za 1 mln tokenów; z nowych modeli 3.1 Flash-Lite: 0,25 USD |
| Promocja z terminem | 3.8 i 3.6 Flash: połowa dzisiejszych stawek to cena promocyjna do 31.12.2026 |
| Dane w planie darmowym | Google pisze wprost: treść z darmowego API służy do ulepszania produktów; na planie płatnym nie |
| Limity darmowe | liczby RPM/TPM widać tylko po zalogowaniu w AI Studio; limit liczy się per projekt, nie per klucz |
| Plan płatny | od przedpłaty minimalnej 5 USD; kolejne poziomy odblokowują kwoty 100 i 1000 USD |
| Częsty błąd | 429 RESOURCE_EXHAUSTED, czyli wyczerpane okno limitów; nowy klucz nic nie zmienia |
Czym różni się darmowe Gemini w aplikacji od darmowego API
Gdy ktoś pisze „Gemini za darmo”, większość ludzi ma w głowie aplikację i stronę gemini.google.com, gdzie bez płacenia czatujesz z modelami w interfejsie Google. API to drugi, osobny świat: te same modele, ale dostępne dla twojego kodu przez internet, z własnym cennikiem, własnymi limitami i osobnym rozliczaniem. Darmowy plan w aplikacji nie daje ci darmowego ruchu w API ani odwrotnie, więc przy przeprowadzce z czatu do programu zaczynasz od zera. Ten pierwszy świat opisaliśmy w osobnym poradniku o darmowym Gemini, a wszystkie nasze materiały o tym ekosystemie trzymamy w zbiorczym poradniku Gemini.
Różnica, którą trzeba poczuć przed napisaniem pierwszej linijki kodu, dotyczy danych. W darmowym planie API Google zastrzega w tabeli cen, że twoje zapytania „są wykorzystywane do ulepszania naszych produktów”. Na planie płatnym ten sam wiersz mówi: nie. Jeśli zamierzasz przepuszczać przez API cokolwiek poufnego, darmowy plan jest złym miejscem na początek, niezależnie od oszczędności. Temat, co modele Google robią z twoimi danymi szerzej, rozłożyliśmy w przeglądzie incydentów bezpieczeństwa Gemini.
Jak zdobyć klucz API za darmo
Klucz jest darmowy i powstaje w kilka minut, ale wymaga konta Google, bo każdy klucz wisi na projekcie Google Cloud. Dla nowych użytkowników AI Studio robi to automatycznie: po zalogowaniu i zaakceptowaniu regulaminu dostajesz projekt i pierwszy klucz bez wchodzenia do konsoli Cloud. Punkt startowy to strona kluczy w AI Studio, a ścieżka wygląda tak:
| Cel | Ścieżka |
|---|---|
| Nowy klucz | aistudio.google.com/apikey, przycisk „Create API key” |
| Konto bez projektu | AI Studio tworzy domyślny projekt po akceptacji regulaminu |
| Projekt z konsoli Cloud | strona Projects, „Import projects”, wybór i „Import” |
| Ograniczenie klucza | etykieta „Unrestricted”, potem „Add restrictions” i „Restrict to Gemini API only” |
| Podgląd limitów | AI Studio, strona rate limits, wymaga zalogowania |
Dwa ograniczenia porządkowe, o których dokumentacja wspomina mimochodem: z poziomu AI Studio utworzysz maksymalnie 10 projektów, a widoki kluczy pokazują do 100 kluczy przy 50 projektach. Na początek wystarczy jeden projekt i jeden klucz.
Od 28 maja 2026 zmienił się sam format kluczy. Wszystkie nowe klucze z AI Studio to klucze uwierzytelniające, a starsze, nieograniczone klucze leżące odłogiem są blokowane i oznaczane etykietą „Blocked”. Jeśli trzymasz klucz z ubiegłego roku w starym skrypcie i nagle przestał działać, to nie limit, tylko ta migracja: wygeneruj nowy klucz i podmień wartość.
Pierwsze zapytanie: sześć linii Pythona
Oficjalna biblioteka czyta klucz ze zmiennej środowiskowej, więc kodu praktycznie nie musisz konfigurować. Po pip install -U google-genai i wystawieniu GEMINI_API_KEY wystarczy:
from google import genai
client = genai.Client()
odp = client.interactions.create(
model="gemini-3.8-flash",
input="Wyjaśnij w jednym zdaniu, czym jest API",
)
print(odp.output_text)SDK istnieje też dla JavaScriptu (npm install @google/genai), Javy, Go i czystego REST-a. Dwa szczegóły, które oszczędzają pół godziny szukania: jeśli ustawisz jednocześnie GEMINI_API_KEY i GOOGLE_API_KEY, wygrywa ta druga, a przykład z dokumentacji z 5 października używa nowszego interfejsu interactions, więc starsze tutoriale z generateContent w sieci to nie błąd, tylko wcześniejsza generacja API.
Ile kosztuje Gemini API: ceny za milion tokenów
Ceny w API podaje się za milion tokenów, osobno za wejście (to, co wysyłasz) i wyjście (to, co model odsyła). Stan cennika z 9 października wygląda tak:
| Model | Wejście (USD / 1 mln) | Wyjście (USD / 1 mln) |
|---|---|---|
| Gemini 3.1 Pro Preview | 2,00 (4,00 ponad 200k kontekstu) | 12,00 (18,00 ponad 200k) |
| Gemini 3.8 Flash | 0,75 do 31.12.2026, potem 1,50 | 3,75, potem 7,50 |
| Gemini 3.6 Flash | 0,75 do 31.12.2026, potem 1,50 | 3,75, potem 7,50 |
| Gemini 3 Flash Preview | 0,50 (audio 1,00) | 3,00 |
| Gemini 3.5 Flash-Lite | 0,30 | 2,50 |
| Gemini 3.1 Flash-Lite | 0,25 (audio 0,50) | 1,50 |
| Gemini 2.5 Pro | 1,25 (2,50 ponad 200k) | 10,00 (15,00 ponad 200k) |
| Gemini 2.5 Flash | 0,30 (audio 1,00) | 2,50 |
| Gemini 2.5 Flash-Lite | 0,10 (audio 0,30) | 0,40 |
| Gemma 4 | 0, tylko plan darmowy | 0, plan płatny niedostępny |
Dwa mechanizmy obniżają te kwoty. Tryb batch, czyli zadania wysyłane do przetworzenia z opóźnieniem, kosztuje o połowę mniej na wszystkich modelach. Cache’owanie kontekstu, przydatne, gdy w każdym zapytaniu wysyłasz tę samą dużą instrukcję systemową, pozwala czytać ją za około 10 procent normalnej ceny wejścia. Osobno rozliczane są narzędzia doklejane do zapytań: na przykład przeszukiwanie internetu w modelach Gemini 3 to 5000 darmowych zapytań miesięcznie i 14 dolarów za każdy kolejny tysiąc.
Notę promocyjną z tabeli trzeba czytać dokładnie tak, jak ją zapisano: stawki dla Flashów 3.8 i 3.6 działają do końca 2026 roku, a od stycznia wracają do podwójnych wartości. W cenniku to cena z 2027 jest „normalna”, dzisiejsza to rabat powitalny. Sam skład cennika też się rusza: Gemini 4 Argon został zapowiedziany 30 września i na razie nie da się go kupić w żadnym planie, więc tabelę przed użyciem porównaj z aktualną wersją u źródła.
Limity darmowego planu: co widać bez logowania
Tu dokumentacja robi coś, co trzeba opisać wprost: Google nie publikuje tabeli limitów darmowego planu na stronie otwartej dla wszystkich. Konkretne liczby żądań na minutę, tokenów na minutę i żądań na dobę widzisz wyłącznie po zalogowaniu w AI Studio, na stronie rate limits. Strona zastrzega też, że podane limity „nie są gwarantowane”, faktyczna pojemność bywa różna, a modele w statusie Preview mają je ściślejsze.
Kilka faktów strukturalnych jest jawnych i one dają ramy, w których te liczby żyją. Limit liczy się per projekt, nie per klucz: wygenerowanie drugiego klucza do tego samego projektu nie podwaja puli. Dzienna pula żądań odnawia się o północy czasu pacyficznego, więc w Polsce reset wypada około dziewiątej rano. Na planach płatnych dochodzą suwaki wydatków w oknach dziesięciominutowych: 10 dolarów na pierwszym poziomie, 50 na drugim, 200 na trzecim. Na darmowym liczą się wyłącznie limity per model.
Plan płatny: pięć dolarów na start i trzy poziomy
Przejście na płatne zaczyna się od przycisku konfiguracji rozliczeń, który w AI Studio stoi przy projekcie w kolumnie poziomu rozliczania. Wybierasz kraj, akceptujesz warunki, podpinasz kartę i wpłacasz minimalną przedpłatę 5 dolarów. To model prepaid: gdy saldo spadnie do zera, wszystkie klucze powiązane z projektami na tym koncie przestają działać z błędem HTTP 402.
Poziomy odblokowują się tym, ile faktycznie zapłacisz. Pierwszy dostajesz samym podpięciem rozliczeń i ma sufit 250 dolarów. Drugi wymaga 100 dolarów zapłaconych i trzech dni od pierwszej udanej płatności, z sufitem 2000. Trzeci to 1000 dolarów i 30 dni, z pułapem od 20 tysięcy wzwyż. Sufit to suma wydatków w cyklu: po jego osiągnięciu usługa pauzuje do pierwszego dnia następnego miesiąca. Rozliczenie wlecze się około dziesięciu minut za rzeczywistym użyciem, więc długie zadania batchowe potrafią przekroczyć limit w trakcie biegu, a saldo przedpłaty może zejść na minus. Google przewiduje to wprost i niedobór rozlicza z następnej wpłaty.
W AI Studio ustawisz też miesięczny limit inwestycji per projekt i włączysz automatyczne doładowania z górną granicą, co przy nieprzewidywalnych skryptach wychodzi taniej niż niespodzianka na karcie.
Co gdy nie działa: od 429 po wyciek klucza
Błąd, który ściąga ludzi z wyszukiwarki, to 429 z komunikatem RESOURCE_EXHAUSTED albo „you exceeded your current quota”. Oznacza jedną rzecz: wyczerpałeś okno limitów i poza czekaniem albo zmianą planu nic tego nie naprawia. Nowy klucz nie pomoże, bo pula liczy się per projekt. Zanim sięgniesz po kartę, sprawdź stronę limitów w AI Studio: pokazuje, który limit padł, minutowy, dzienny czy tokenowy, i często okazuje się, że wystarczy odczekać do resetu dobowego.
Drugi klasyk to odmowa dostępu przy kluczach, które wczoraj działały. Najczęstsze przyczyny bywają prozaiczne: klucz wklejony ze zbędnym znakiem równości albo spacją, wartość nadpisana przez starszą zmienną GOOGLE_API_KEY w tym samym środowisku, albo stary nieograniczony klucz oznaczony od maja 2026 etykietą „Blocked”. HTTP 402 to sygnał przedpłaty: saldo na zerze, trzeba doładować kredytów.
Osobna kategoria to awaria z twojej winy, którą dokumentacja opisuje z pełną powagą: klucz wyciekł, bo trafił do repozytorium albo siedzi na sztywno w kodzie strony. Procedura Google ma cztery kroki: wygeneruj nowy klucz, wdroż go w miejsce starego, wyłącz stary (kasowanie zostaw na koniec, po upewnieniu się, że nic już go nie używa) i przejrzyj logi rozliczeń pod kątem obcych zapytań. Profilaktycznie klucz trzymaj w zmiennej środowiskowej, a w aplikacjach webowych klient rozmawia z twoim backendem, nie z API bezpośrednio, bo z kodu przeglądarkowego da się wyciągnąć wszystko.
Gemini API z Polski: płatność, język, podatki
Dokumentacja Gemini API jest po angielsku i nic nie zapowiada polskiej wersji; AI Studio również nie ma polskiego interfejsu. Ceny są wyłącznie w dolarach amerykańskich, bez wariantu złotówkowego, a przy konfiguracji rozliczeń wybierasz kraj i formę płatności: karta księguje od razu, przelew bankowy według dokumentacji może zająć kilka dni.
O podatkach strony API nie mówią nic konkretnego: nie ma tam sekcji o VAT ani o fakturach w polskim rozumieniu. Przy wydatkach firmowych rozwiązaniem bywa prowadzenie rozliczeń przez konto Google Cloud z pełną fakturą, ale to terytorium poza dokumentacją Gemini API, więc szczegółów nie zgadujemy. Pewne jest natomiast tyle: nie ma ograniczeń krajowych na poziomie API, Polska nie figuruje na żadnej liście wykluczeń, a darmowy klucz działa na polskim koncie Google.
Najczęstsze pytania
Czy klucz Gemini API jest darmowy?
Tak, samo wygenerowanie klucza nic nie kosztuje i nie wymaga karty. Płacisz dopiero za ruch ponad darmowe limity, i to na planie płatnym z przedpłatą.
Czy darmowy klucz Gemini API jest nieograniczony?
Nie. Darmowy plan ma limity żądań i tokenów per model, których liczby Google pokazuje po zalogowaniu w AI Studio. Przekroczenie kończy się błędem 429.
Jak zdobyć klucz Gemini API za darmo?
Wejdź na aistudio.google.com/apikey pod kontem Google i kliknij „Create API key”. Nowi użytkownicy dostają projekt i klucz automatycznie po zaakceptowaniu regulaminu.
Ile kosztuje Gemini API?
Od 0,10 USD za milion tokenów wejścia (2.5 Flash-Lite) do 2 USD i więcej za modele Pro. Wyjście jest droższe niż wejście wszędzie, a tryb batch obniża wszystko o połowę.
Jakie są limity darmowego Gemini API?
Liczby RPM, TPM i RPD per model widać tylko w AI Studio po zalogowaniu. Publicznie znana struktura: limit per projekt, reset dobowy o północy czasu pacyficznego, brak gwarancji wartości.
Co oznacza błąd 429 RESOURCE_EXHAUSTED?
Wyczerpane okno limitów planu darmowego lub płatnego. Zwykle pomaga czekanie do resetu okna; jeśli 429 wraca codziennie, to znak, że czas na plan płatny albo tryb batch.
Nota uczciwości
Klucza nie zakładaliśmy i zapytań nie wykonaliśmy: wymaga to konta Google, a w tym projekcie ścieżki wymagające żywych kont opisujemy wg dokumentacji z datą (precedens z poradnikiem o pamięci ChatGPT). Wszystkie ceny, limity i etykiety przycisków pochodzą z pięciu stron oficjalnej dokumentacji Google, sprawdzonych 13 października 2026; przykładowy kod Pythona jest cytowany z quickstartu, nie z naszego uruchomienia. Ceny promocyjne Flashów mają datę końca w samej tabeli cennika, więc tekst zaktualizujemy, gdy stawki 2027 wejdą w życie.
Źródła
- Cennik Gemini API (aktualizacja 9.10.2026): ai.google.dev/gemini-api/docs/pricing
- Limity żądań (aktualizacja 9.10.2026): ai.google.dev/gemini-api/docs/rate-limits
- Klucze API i uwierzytelnianie: ai.google.dev/gemini-api/docs/api-key
- Rozliczenia (aktualizacja 28.09.2026): ai.google.dev/gemini-api/docs/billing
- Quickstart (aktualizacja 5.10.2026): ai.google.dev/gemini-api/docs/quickstart