Na tej stronie znajdziesz informacje o rozwiązywaniu problemów z typami kodów błędów w przypadku pakietów SDK Gemini API i Firebase AI Logic.
Błąd 400: API key not valid. Please pass a valid API key.
Jeśli otrzymasz błąd 400 z komunikatem API key not valid. Please pass a valid API key., zwykle oznacza to, że klucz interfejsu API w pliku lub obiekcie konfiguracji Firebase nie istnieje albo nie jest skonfigurowany do używania z aplikacją lub projektem Firebase.
Sprawdź, czy klucz interfejsu API wymieniony w pliku konfiguracyjnym lub obiekcie Firebase jest zgodny z kluczem interfejsu API aplikacji. Wszystkie klucze interfejsu API możesz wyświetlić w panelu Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.
Jeśli okaże się, że nie pasują, pobierz nowy plik/obiekt konfiguracji Firebase, a następnie zastąp nim ten, który znajduje się w aplikacji. Nowy plik/obiekt konfiguracji powinien zawierać prawidłowy klucz interfejsu API dla Twojej aplikacji i projektu Firebase.
Błąd 400: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Jeśli próbujesz wysłać żądanie multimodalne z adresem URL Cloud Storage for Firebase, może pojawić się ten błąd 400:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Ten błąd jest spowodowany tym, że w projekcie nie zostały prawidłowo automatycznie utworzone wymagane agenty usług, gdy w projekcie włączono interfejs Vertex AI API. Jest to znany problem, który występuje w przypadku niektórych projektów. Pracujemy nad jego globalnym rozwiązaniem.
Oto obejście, które pozwoli naprawić projekt i prawidłowo udostępnić te agenty usług, aby można było uwzględniać adresy URL Cloud Storage for Firebase w żądaniach multimodalnych. Musisz mieć w projekcie rolę właściciela. Ten zestaw zadań wystarczy wykonać w projekcie tylko raz.
Uzyskaj dostęp i uwierzytelnij się za pomocą urządzenia gcloud CLI.
Najłatwiej zrobić to na stronie Cloud Shell. Więcej informacji znajdziesz w Google Cloud dokumentacji.Jeśli pojawi się monit, postępuj zgodnie z instrukcjami wyświetlanymi w terminalu, aby uruchomić gcloud CLI w projekcie Firebase.
Potrzebny Ci będzie identyfikator projektu Firebase, który znajdziesz u góry settings ustawień projektu w Firebase konsoli.
Aby udostępnić w projekcie wymaganych agentów usługi, uruchom to polecenie:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
Poczekaj kilka minut, aż agenci usługi zostaną udostępnieni, a następnie spróbuj ponownie wysłać żądanie multimodalne zawierające adres URL Cloud Storage for Firebase.
Jeśli po odczekaniu kilku minut nadal widzisz ten błąd, skontaktuj się z zespołem pomocy Firebase.
Błąd 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.
Jeśli otrzymasz błąd 403 z komunikatem Requests to this API firebasevertexai.googleapis.com ... are blocked., zwykle oznacza to, że klucz interfejsu API w konfiguracji Firebase w aplikacji ma ograniczenia, które uniemożliwiają wywoływanie wymaganego interfejsu API.
Aby rozwiązać ten problem, musisz zaktualizować ograniczenia klucza interfejsu API w konsoli Google Cloud, aby uwzględnić wymagany interfejs API. W przypadku Firebase AI Logic musisz się upewnić, że Firebase AI Logic API (firebasevertexai.googleapis.com) znajduje się na liście wybranych interfejsów API, które można wywoływać za pomocą klucza interfejsu API.
Aby to zrobić:
W konsoli Google Cloud otwórz panel Interfejsy API i usługi > Dane logowania.
Wybierz klucz interfejsu API, który ma być używany przez Twoją aplikację (np. „Klucz iOS” w przypadku aplikacji na iOS).
Na stronie Edytuj klucz interfejsu API znajdź sekcję Ograniczenia interfejsów API.
Sprawdź, czy wybrana jest opcja Ogranicz klucz. Jeśli nie, klucz jest nieograniczony i prawdopodobnie nie jest źródłem błędu.
W menu Wybrane interfejsy API wyszukaj i wybierz Firebase AI Logic API, aby dodać go do listy wybranych interfejsów API, które można wywoływać za pomocą klucza interfejsu API.
Kliknij Zapisz.
Zastosowanie zmian może potrwać do 5 minut.
Błąd 403: PERMISSION_DENIED: The caller does not have permission.
Jeśli otrzymasz błąd 403 z komunikatem PERMISSION_DENIED: The caller does not have permission., zwykle oznacza to, że klucz interfejsu API w pliku lub obiekcie konfiguracji Firebase należy do innego projektu Firebase.
Sprawdź, czy klucz interfejsu API wymieniony w pliku konfiguracyjnym lub obiekcie Firebase jest zgodny z kluczem interfejsu API aplikacji. Wszystkie klucze interfejsu API możesz wyświetlić w panelu Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.
Jeśli okaże się, że nie pasują, pobierz nowy plik/obiekt konfiguracji Firebase, a następnie zastąp nim ten, który znajduje się w aplikacji. Nowy plik/obiekt konfiguracji powinien zawierać prawidłowy klucz interfejsu API dla Twojej aplikacji i projektu Firebase.
Błąd 404: Firebase AI Logic genai config not found
Jeśli próbujesz użyć Gemini Developer API i pojawi się błąd 404 z komunikatem Firebase AI Logic genai config not found, zwykle oznacza to, że w projekcie Firebase nie ma prawidłowego klucza interfejsu API Gemini do użycia z pakietami SDK klienta Firebase AI Logic.
Oto najbardziej prawdopodobne przyczyny tego błędu:
Nie masz jeszcze skonfigurowanego projektu Firebase na potrzeby usługi Gemini Developer API.
Co zrobić:
W konsoli Firebase otwórz Usługi AI > Logika AI. Kliknij Rozpocznij, a następnie wybierz Gemini Developer API. Włącz interfejs API, a konsola skonfiguruje projekt pod kątem Gemini Developer API. Po zakończeniu tego procesu spróbuj ponownie.Jeśli niedawno przeszedłeś(-aś) proces konfiguracji Firebase AI Logic w Firebase konsoli, Twój klucz interfejsu API Gemini może nie być jeszcze dostępny dla wszystkich wymaganych usług backendu we wszystkich regionach.
Co zrobić:
Poczekaj kilka minut i spróbuj ponownie.Twój Gemini klucz interfejsu API mógł zostać usunięty z Twojego projektu Firebase.
Co zrobić:
Dowiedz się, jak zmienić klucz interfejsu API Gemini używany przez Firebase AI Logic.
Błąd 404: model „was not found or your project does not have access to it”?
Przykład: „Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version.”
Przyczyny pojawienia się takiego błędu mogą być różne.
Nieprawidłowa nazwa modelu
Przyczyna: podana nazwa modelu jest nieprawidłowa.
Rozwiązanie: sprawdź nazwę i wersję modelu na liście wszystkich obsługiwanych i dostępnych modeli. Sprawdź segmenty i ich kolejność w nazwie modelu. Przykład:
- Nazwa najnowszego modelu Gemini 3.x Pro:
gemini-3.1-pro-preview(dostępna tylko w wersji podglądowej) - Nazwa najnowszego modelu Gemini 3.x Flash:
gemini-3.5-flash - Nazwa najnowszego modelu Gemini 3.x Flash‑Lite:
gemini-3.1-flash-lite - Najnowszy model Gemini 3.x Pro Image (nazywany też „Nano Banana Pro”)
nazwa modelu:
gemini-3-pro-image - Najnowszy model Gemini 3.x Flash Image (znany też jako „Nano Banana 2”)
nazwa modelu:
gemini-3.1-flash-image - Najnowsza wersja Gemini 3.x Flash‑Lite Image (czyli „Nano Banana 2 Lite”)
nazwa modelu:
gemini-3.1-flash-lite-image - Nazwa najnowszego modelu Gemini 2.5 Flash Image (czyli „Nano Banana”):
gemini-2.5-flash-image
- Nazwa najnowszego modelu Gemini 3.x Pro:
Nieprawidłowa lokalizacja (dotyczy tylko dostawcy Vertex AI Gemini API)
Przyczyna: każde żądanie korzystające z Vertex AI Gemini API musi zawierać lokalizację, aby uzyskać dostęp do modelu. Twoja prośba może dotyczyć dostępu do modelu w lokalizacji, w której nie jest on dostępny.
Rozwiązanie: upewnij się, że żądanie próbuje uzyskać dostęp do modelu, w którym jest on dostępny.
Gdy używasz Vertex AI Gemini API, Firebase AI Logic ma domyślnie wartość
us-central1. Jednak nie wszystkie modele są obsługiwane wus-central1. Oznacza to, że w zależności od modelu podczas inicjowania może być konieczne wyraźne ustawienie konkretnej lokalizacji.Gemini Modele wersji podglądowej i eksperymentalne: ustawienie lokalizacji na
globaljest wymagane (z wyjątkiem modeli Live API). Wszystkie wersje testowe i eksperymentalne Gemini modeli (z wyjątkiem modeli Live API) są dostępne tylko wglobal.Gemini 3.x modele: w przypadku korzystania z Firebase AI Logic wymagane jest ustawienie lokalizacji na
global. Firebase AI Logicnie obsługuje jeszcze lokalizacjiusieu.Gemini 2.5 modele: ustawienie lokalizacji jest opcjonalne. Jeśli nie określisz lokalizacji, domyślną wartością będzie
us-central1.Gemini Live API modele: ustawienie lokalizacji jest opcjonalne. Jeśli nie określisz lokalizacji, domyślną wartością będzie
us-central1. Pamiętaj, że lokalizacjaglobalnie jest obsługiwana.
Dowiedz się więcej o tym, jak określić lokalizację dostępu do modelu (w tym fragmenty kodu).
Błędy 429: "You exceeded your current quota, please check your plan and billing details" lub "Resource exhausted, please try again later."
Błędy 429 wskazują, że przekraczasz limit lub model, do którego uzyskujesz dostęp, jest przeciążony żądaniami innych osób.
Działanie, które należy podjąć, zależy od tego, czy używasz Gemini Developer API czy Vertex AI Gemini API. Więcej informacji o limitach i sposobie zgłaszania próśb o dodatkowe limity znajdziesz w sekcji Limity.
Jeśli używasz Vertex AI Gemini API, w Google Cloud dokumentacji znajdziesz dodatkowe informacje i wskazówki dotyczące kodu błędu 429.