Gemini API: błędy dotyczące regionu, bezpłatnego planu i uprawnień klucza API

Nie każdy błąd Gemini dotyczy jednak Twojego regionu. Jeden dotyczy bezpłatnego planu, a inny samego klucza API. Jeśli chodzi o programowanie, Gemini wydaje mi się trochę mało bystry, choć nie raz dawałem mu kolejną szansę.

Wyjaśnię, jak na podstawie komunikatu o błędzie ustalić, co się stało, i czego używać zamiast Gemini. Zaczynajmy.

Informacje o korzystaniu z usługi znajdziesz w dokumentacji Ailoot.

Jak sprawdzić regiony obsługiwane przez Gemini?#

Google prowadzi osobną stronę z listą miejsc, w których działają Gemini API i Google AI Studio:

Tłumaczenie: „Gemini API i Google AI Studio są dostępne w następujących krajach i terytoriach. Jeśli nie znajdujesz się w jednym z nich, wypróbuj Gemini API na platformie Gemini Enterprise Agent Platform”.

Lista zawiera 230 pozycji, od Albanii po Wyspy Alandzkie. Gemini Enterprise Agent Platform to platforma Google Cloud.

Jeśli zamiast do AI Studio następuje przekierowanie na tę stronę, Google podaje 3 powody: Twój region, wiek poniżej 18 lat oraz niezweryfikowany wiek na koncie Google.

403 Access Restricted: co ma z tym wspólnego Twój region?#

Google opisuje to tak:

Tłumaczenie: „Jeśli widzisz błąd 403 Access Restricted, korzystasz z Google AI Studio w sposób naruszający Warunki korzystania z usługi. Jednym z częstych powodów jest przebywanie poza obsługiwanym regionem”.

Twój region to 1 z 4 sprawdzanych kryteriów. Pozostałe 3 to:

• żądanie musi przejść automatyczne kontrole bezpieczeństwa;
• musisz zaakceptować Warunki korzystania z usługi Google oraz dodatkowe warunki dotyczące generatywnej AI;
• projekt Google Cloud nie może być oznaczony jako naruszający zasady.

400 FAILED_PRECONDITION i bezpłatny plan#

Ten błąd dotyczy płatności. Oto komunikat z tabeli błędów Gemini API:

Tłumaczenie: „Bezpłatny plan Gemini API nie jest dostępny w Twoim kraju. Włącz rozliczenia dla projektu w Google AI Studio”.

Google zaleca włączenie płatnego planu w AI Studio. Działa to jednak tylko w krajach z listy.

403 PERMISSION_DENIED: przeczytaj komunikat#

Numer jest taki sam, ale komunikat w tabeli błędów jest inny:

Tłumaczenie: „Twój klucz API nie ma wymaganych uprawnień”.

Według Google przyczyną może być wybranie niewłaściwego klucza albo uzyskiwanie dostępu do dostrojonego modelu bez wymaganej autoryzacji. Sprawdź, czy klucz jest prawidłowy i zapewnia dostęp.

Jednak w AI Studio ten sam błąd PERMISSION_DENIED pojawia się również podczas sprawdzania regionu. Google opisuje to na stronie poświęconej 4 kontrolom. Dlatego czytaj komunikat. Jeśli wspomina o uprawnieniach klucza, sprawdź klucz. Jeśli wspomina o Twoim regionie, klucz nie ma z tym nic wspólnego.

Czy warto nadal korzystać z Gemini?#

Do programowania — moim zdaniem nie. Mam Gemini w planie najwyższego poziomu, ale nie tworzę za jego pomocą programów. Używam go do filmów i zdjęć. Przez miesiąc pracowałem w Google Antigravity, programie Google do pracy z kodem, a mimo to wróciłem do VS Code.

Nie ma znaczenia, że Gemini może pomieścić w pamięci 1 million tokenów: jest trochę mniej inteligentny niż ChatGPT. Antigravity nie jest głupi i podoba mi się, ale jakość wciąż jest niestety znacznie gorsza. Jeśli nie ma nic innego, sprawdzi się: lepiej mieć cokolwiek niż nic.

Gemini dobrze radzi sobie z dogłębnym wyszukiwaniem informacji na dany temat w internecie. W końcu to Google: zbiera każdą stronę internetową, a każda strona go wpuszcza. Dlatego takie badania przeprowadzam w Gemini zamiast w Claude: Claude jest drogi i zużyje mnóstwo tokenów. Pamiętaj jednak, że Gemini pisze dużo i rozwlekle, a do tego nie potrafi wyłowić najważniejszej informacji.

Czego używać zamiast Gemini#

Moja kolejność jest następująca. Claude Code — bo jest po prostu inteligentniejszy. Po co wybierać mniej inteligentny model, skoro można skorzystać z najinteligentniejszego? Jeśli nie da się go uruchomić, użyj ChatGPT Codex: łatwiej uzyskać do niego dostęp i jest mniej blokad. Jeśli to też nie zadziała, pozostają chińskie modele.

Przykład na filmie porównuje inne modele do vibe codingu:

Film omawia Codex, Gemini, Qwen, Cursor, Lovable, Bolt i v0 oraz wyjaśnia wybór Claude Code w opisanym przykładzie pracy.

Qwen. Qwen to chiński model. Jest mniej więcej 10% słabszy od Opus, najmocniejszego modelu Claude; jest całkiem dobry, ale wolny. Też go używam, głównie do sprawdzania kodu pod kątem błędów. Sposób konfiguracji opisałem w osobnym artykule.

DeepSeek. To chińska platforma. Nie radzi sobie jednak z zadaniami trwającymi kilka godzin: wypróbowałem ją i po drodze się psuje. Różnice między nią a ChatGPT opisałem w osobnym artykule.

W osobnym artykule wyjaśniłem, który model wybrać do poszczególnych zadań, aby nie przepłacać.

Jeśli Gemini jest częścią Twojego produktu#

Od początku uwzględnij model rezerwowy. W opisanym przypadku użyto oficjalnego API ChatGPT, a konto zostało zablokowane: usługa przetworzyła tekst użytkownika zawierający obraźliwe uwagi. Użytkownik nawet nie zauważył blokady, ponieważ po otrzymaniu odmowy usługa przełączyła się na chiński model.

Podobny opis błędu regionalnego w Claude Code znajdziesz w osobnym artykule.

Jeśli Gemini i Claude są niedostępne w Twoim regionie, porównaj dostępne alternatywy pod kątem swojego zadania.

Poznaj Ailoot.