Gemini API: jak zdobyć klucz, darmowe limity i ceny w złotych

👁 120 przeczytań

Gemini API to sposób, żeby Twój program, skrypt albo automatyzacja rozmawiały z modelami Google bez okna czatu. Klucz dostajesz w Google AI Studio w minutę, bez karty, a darmowy poziom wystarcza na testy i małe narzędzia. Płacisz dopiero po podpięciu rozliczeń, za tokeny: od 0,75 USD za milion tokenów wejścia w Gemini 3.8 Flash. Poniżej krok po kroku, gdzie trzymać klucz, jakie są limity darmowe i ile kosztują trzy typowe scenariusze w złotych.

Co to jest Gemini API i czym różni się od aplikacji

Aplikacja Gemini (gemini.google.com) to gotowy czat dla ludzi z abonamentem Google AI. Gemini API to ten sam model wystawiony pod adresem, na który Twój kod wysyła zapytanie i dostaje odpowiedź w formacie JSON. Rozliczenie jest za zużyte tokeny, a nie za miesiąc. Trzecia droga, Vertex AI, to to samo API w Google Cloud, z fakturą na firmę, kontrolą regionu danych i wyższymi limitami; dla jednej osoby to nadmiar konfiguracji.

// chwilowo wyprzedane - wraca w kolejnej dostawiebrak w magazynie

Google AI Gemini Pro + Google Drive 5 TB - 18 miesięcyVoucher, którym włączasz pakiet Google AI Pro na 18 miesięcy na własnym koncie Google.kinetyka.pl - mój sklep z rocznymi dostępami do narzędzi AI

170 zł-91%zamiast 1 800 zł9,44 zł / mies.Powiadom mnie o dostawie →

Do zabawy bez pisania kodu służy Google AI Studio: wpisujesz prompt, zmieniasz model i parametry, a przyciskiem „Get code” dostajesz gotowy fragment w Pythonie, JavaScripcie albo curl. Szerszy opis jest w naszym przewodniku po AI Studio.

Klucz API krok po kroku

• Wejdź na aistudio.google.com/apikey, zaloguj się kontem Google i zaakceptuj regulamin. Nowe konto dostaje automatycznie projekt Google Cloud i klucz.
• Kliknij „Create API key”. Klucz to ciąg znaków zaczynający się od „AIza”. Skopiuj go od razu, bo później zobaczysz tylko jego fragment.
• Zapisz klucz w zmiennej środowiskowej GEMINI_API_KEY. Biblioteki Google odczytują ją same, więc w kodzie nie ma klucza.
• Nie wklejaj klucza do repozytorium ani do kodu strony czy aplikacji mobilnej; każdy może go wyciągnąć z przeglądarki. Zapytania z frontu przepuszczaj przez własny serwer.
• W AI Studio ogranicz klucz do Gemini API, a w Google Cloud ustaw alert rozliczeniowy. Jeśli klucz wycieknie, wygeneruj nowy, podmień w aplikacji i dopiero potem wyłącz stary.

Darmowy poziom i limity

Limity liczone są na trzy sposoby naraz: zapytania na minutę (RPM), tokeny na minutę (TPM) i zapytania na dzień (RPD). Przekroczenie któregokolwiek daje błąd 429. Limity dotyczą projektu, nie klucza: drugi klucz w tym samym projekcie niczego nie zwiększa. Dzienne liczniki zerują się o północy czasu pacyficznego.

Google nie publikuje już tabeli darmowych limitów w dokumentacji, tylko pokazuje je w panelu AI Studio dla Twojego projektu. Według zestawień z września 2026 modele Flash 3.x mają na darmowym poziomie rzędu 20 zapytań dziennie, a Flash-Lite ok. 500; wcześniejsze zestawienia z wiosny podawały 250-1500. Traktuj te liczby orientacyjnie i sprawdź własny panel. Modele Pro są dostępne tylko po podpięciu rozliczeń.

Poziomy płatne: Tier 1 dostajesz od razu po podpięciu karty (limit wydatków 250 USD), Tier 2 po wydaniu 100 USD i 3 dniach, Tier 3 po 1000 USD i 30 dniach. Dodatkowo działają limity 10-minutowe: 10, 50 i 200 USD.

Cennik płatny w złotych

Ceny bez VAT, kurs NBP 3,857 zł. Tokeny „myślenia” modelu liczą się jako wyjście. Batch API (odpowiedź do 24 godzin) jest o połowę tańsze. Wyszukiwanie Google jako narzędzie: 5000 zapytań miesięcznie gratis, potem 14 USD za tysiąc.

Trzy scenariusze na Gemini 3.8 Flash i Flash-Lite:

• Chatbot na stronie, 1000 rozmów dziennie po 1500 tokenów wejścia i 300 wyjścia: ok. 2,25 USD dziennie, ok. 68 USD miesięcznie (ok. 262 zł).
• Tłumaczenie 100 dokumentów po 5000 słów (ok. 8 tys. tokenów w każdą stronę): ok. 3,60 USD (ok. 14 zł) jednorazowo.
• 10 000 opisów produktów na Flash-Lite, 300 tokenów wejścia i 200 wyjścia: ok. 5,90 USD (ok. 23 zł).

Próg, przy którym API wychodzi taniej niż abonament, policzyliśmy w tekście abonament czy API.

Pierwsze zapytanie

W terminalu (klucz w zmiennej środowiskowej):

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent" -H "x-goog-api-key: $GEMINI_API_KEY" -H "Content-Type: application/json" -d '{"contents":[{"parts":[{"text":"Wyjaśnij w dwóch zdaniach, co to jest token."}]}]}'

W Pythonie po pip install google-genai:

from google import genai
client = genai.Client()
r = client.models.generate_content(model="gemini-3.8-flash", contents="Wyjaśnij w dwóch zdaniach, co to jest token.")
print(r.text)

Błąd 429 oznacza przekroczony limit: odczekaj i ponów z rosnącym odstępem (1, 2, 4, 8 sekund), a w produkcji ustaw kolejkę zapytań. Błąd 400 z komunikatem o kluczu to zwykle klucz z innego projektu albo bez uprawnień do Gemini API.

Najczęstsze pytania

Czy Gemini API jest darmowe?

Tak, na darmowym poziomie bez karty, z małymi limitami dziennymi (rzędu kilkudziesięciu zapytań dla modeli Flash 3.x według zestawień z września 2026). Po podpięciu rozliczeń płacisz za tokeny od pierwszego zapytania.

Czy dane z API trenują modele Google?

Na darmowym poziomie tak: regulamin mówi, że Google używa treści do ulepszania produktów, a ludzie mogą przeglądać próbki. Na poziomie płatnym nie. Regulamin zaznacza, że użytkownicy z UE, Wielkiej Brytanii i Szwajcarii podlegają warunkom usług płatnych, także gdy nie płacą.

Czy trzeba podać kartę?

Do klucza i darmowego poziomu nie. Kartę podajesz w Google Cloud, gdy chcesz wyższe limity, modele Pro i gwarancję, że dane nie idą do treningu.

Czym różni się Gemini API od Vertex AI?

Modele są te same. Vertex AI to wersja w Google Cloud dla firm: faktura, wybór regionu, IAM i umowy o przetwarzaniu danych. Do własnych projektów wystarczy Gemini API.