Gemini API: jak zdobyć klucz, wywołać model i ile kosztują tokeny
Gemini API to sposób, w jaki wywołujesz modele Gemini z własnego kodu zamiast z okna czatu: bot wsparcia na Twojej stronie, skrypt selekcjonujący zgłoszenia, uzupełnianie kodu w edytorze, integracja z CRM. Trasa klasyczna wymaga konta Google, konfiguracji rozliczeń w chmurze i karty zagranicznej. W przypadku NeuralSpace ścieżka jest krótsza: w ciągu około minuty na Twoim dashboardzie tworzony jest klucz, model jest wywoływany z żądaniem zgodnym z OpenAI, a Ty płacisz z salda tokenów – bez subskrypcji. Poniżej poradnik krok po kroku: jak zdobyć klucz, jak wygląda pierwsze wywołanie Gemini 3.8 Flash i ile kosztują tokeny.
Czym jest Gemini API i komu jest potrzebne
Gemini to rodzina modeli językowych Google. Poprzez API jest ona otwarta dla programistów: wysyłasz szereg wiadomości, otrzymujesz wygenerowaną odpowiedź i wykorzystujesz ją w swoim produkcie — pokazujesz ją użytkownikowi, przechowujesz, przetwarzasz dalej. Typowe przypadki użycia: obsługa chatbotów, podsumowywanie e-maili i dokumentów, wydobywanie ustrukturyzowanych danych z tekstu, tworzenie treści, automatyzacja procedur w skryptach. Gemini 3.8 Flash w katalogu NeuralSpace to szybka gałąź rodziny: równowaga szybkości i ceny, która pasuje do dialogów i masowego przetwarzania tekstu.
Krok 1. Zdobądź klucz
- Zarejestruj się NeuralSpace, podając swój adres e-mail — zajmie to mniej niż minutę. Nowi użytkownicy otrzymują od razu tokeny startowe, które wystarczą na pierwsze API połączeń bez doładowania.
- Otwórz Strona z kluczami API na pulpicie nawigacyjnym i utwórz klucz. Klucz wygląda jak BLK0 i jest wyświetlany raz — zapisz go natychmiast w menedżerze haseł lub zmiennej środowiskowej, a nie w repozytorium.
- Sprawdź saldo: modele tekstowe wymagają minimum 50 tokenów na koncie. Doładowania odbywają się w panelu kontrolnym — bez kart zagranicznych i bez opłat abonamentowych.
Krok 2. Wywołaj model
Gemini publicznie API działa poprzez punkt końcowy BLK1 zgodny z OpenAI: treść zawiera model, tablicę BLK2 z rolami system/użytkownik/asystent i limit BLK3. Minimalne żądanie zwijania:
BLK4
Odpowiedź przychodzi w formacie OpenAI: wygenerowany tekst znajduje się w BLK5, rzeczywiste użycie jest w BLK6. Jeśli masz już kod OpenAI SDK, zmieniają się dokładnie dwie wartości — base_url i klucz:
BLK7
Interfejsy czatu czerpią korzyści z przesyłania strumieniowego: dodaj BLK8, a odpowiedź będzie przychodzić w kawałkach za pośrednictwem zdarzeń wysyłanych przez serwer, dzięki czemu użytkownik zobaczy pierwsze słowa przed zakończeniem generowania.
Krok 3. Wiedz, ile to kosztuje
Rozliczenia są liczone: żetony wejściowe (Twoja zachęta) i żetony wyjściowe (odpowiedź modelu) są liczone osobno, każdy z własną ceną za milion. W przypadku Gemini 3.8 Flash w momencie pisania tego tekstu jest to 33,5 tokenów na milion danych wejściowych i 168 tokenów na milion danych wyjściowych. Typowe żądanie „2000 tokenów kontekstu + 500 tokenów wyjściowych” kosztuje około 0,15 tokena. Cena jest powiązana z kursem wymiany i jest zmienna, dlatego przed wykonaniem obliczeń sprawdź tabelę na żywo: jest ona publikowana na stronie Strona dokumentacji API i zwrócony w formie do odczytu maszynowego przez BLK9. Dla porównania: DeepSeek V4 Flash w tym samym katalogu to 21/42 tokenów na milion, modele Claude są zauważalnie droższe; Gemini 3,8 Flash plasuje się pośrodku ceny i szybko odpowiada.
Dwa limity usług: 60 żądań na minutę na klucz i minimalne saldo 50 tokenów dla modeli tekstowych. Aktualne saldo jest dostępne poprzez BLK10, opłaty pojawiają się w historii transakcji Twojego profilu.
Gemini na stronie — kod nie jest potrzebny
Jeśli nie potrzebujesz jeszcze API, w interfejsie znajdują się te same modele: wybierz Gemini 3.8 Flash w pogawędzić — wyszukiwanie w Internecie jest tam włączone — a w przypadku obrazów generowanie obrazu sekcja oferuje Nano Banana, model oparty na Gemini 2.5 Flash. Saldo jest współdzielone: czat i API losowanie z tego samego konta.
Typowe błędy pierwszego żądania
- 401 Nieautoryzowane — klucz został przekazany niepoprawnie: dodatkowa spacja, obcięta wartość, błędny przedrostek. Pełny klucz znajduje się po BLK11 lub w nagłówku BLK12.
- 429 Za dużo żądań — osiągnąłeś limit 60 żądań na minutę. Dodaj pauzę lub kolejkę po swojej stronie.
- Błąd balansu — mniej niż 50 tokenów na koncie: doładuj w panelu i spróbuj ponownie.
- Klucz wyciekł do gita — przechowuj go w zmiennych środowiskowych (.env) i nigdy go nie popełniaj; jeśli wycieknie, wydaj ponownie klucz na tej samej stronie kluczy API.
Często zadawane pytania
Czy potrzebuję konta Google czy karty zagranicznej?
Nie. Klucz jest wydawany w Twoim panelu kontrolnym NeuralSpace i płacisz z salda tokenów: rozliczenia oparte na tokenach, brak subskrypcji, brak rozliczeń w chmurze.
Ile kosztuje połączenie Gemini API?
Tylko rzeczywiste tokeny: w momencie pisania tego tekstu 33,5 tokenów na milion danych wejściowych i 168 na milion wyników dla Gemini 3,8 Flash; żądanie kilku tysięcy tokenów to około 0,15 tokenów. Aktualne ceny znajdują się w BLK13 i tabeli dokumentacji.
Czy istnieje poziom bezpłatny?
Na platformie nie ma wolnych generacji. Nowi użytkownicy otrzymują tokeny startowe — wystarczające na pierwsze eksperymenty — po czym płacisz za token bez opłaty abonamentowej.
Co jeszcze może zrobić API poza tekstem?
Za pomocą tego samego klucza uzyskasz generowanie obrazów, wideo i muzyki, syntezę i rozpoznawanie mowy oraz serwer MCP pod adresem https://neuralspace.pro/mcp dla agentów AI. Pełna lista punktów końcowych znajduje się w dokumentacji.