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 konfiguracyjnym Firebase nie istnieje lub nie jest skonfigurowany do używania z aplikacją lub projektem w Firebase.
Sprawdź, czy klucz interfejsu API wymieniony w pliku/obiekcie konfiguracji 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ą, uzyskaj 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 aplikacji i projektu w 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 zainicjowane wymagane agenty usług, gdy w projekcie włączono interfejs Agent Platform API. Jest to znany problem w przypadku niektórych projektów. Pracujemy nad 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 zacząć uwzględniać adresy Cloud Storage for Firebase URL w żądaniach multimodalnych. Musisz być właścicielem projektu. Ten zestaw zadań musisz wykonać tylko raz w przypadku danego projektu.
Uzyskaj dostęp i uwierzytelnij się za pomocą 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 w Firebase.
Potrzebny Ci będzie identyfikator projektu w Firebase, który znajdziesz u góry settings ustawień projektu w Firebase konsoli.
Udostępnij w projekcie wymaganych agentów usługi, uruchamiając 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 Cloud Storage for Firebase URL.
Jeśli po kilku minutach nadal widzisz ten błąd, skontaktuj się z zespołem pomocy Firebase.
Błąd 403: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
Jeśli otrzymasz błąd 403 - PERMISSION_DENIED, który mówi:To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, oznacza to, że Twoje żądanie nie zawiera prawidłowego tokena App Check i próbujesz uzyskać dostęp do modelu, który jest często nadużywany.
Niektóre modele generatywne są często wykorzystywane przez osoby o złych zamiarach.
Ponieważ nie masz włączonego App Check w przypadku Firebase AI Logic, Twój projekt jest podatny na nadużycia związane z tymi modelami. Aby chronić naszych deweloperów, Firebase blokuje dostęp do tych modeli, chyba że żądanie zawiera prawidłowy token App Check (co oznacza, że App Check jest wymuszane w przypadku Firebase AI Logic).
Jeśli chcesz uzyskać dostęp do modelu, który zwrócił błąd, wykonaj te czynności:
Skonfiguruj App Check dla Firebase AI Logic. W przypadku programowania lokalnego skonfiguruj App Check dostawcę debugowania.
Egzekwowanie App Check ma kluczowe znaczenie dla ochrony Gemini API i Gemini przed nadużyciami. Aby usunąć ten błąd, musisz egzekwować te zasady.
Ponownie wyślij prośbę z aplikacji do Firebase AI Logic.
To żądanie wyśle prawidłowy token App Check i nie będzie już zwracać błędu
403 - PERMISSION_DENIED.Zanim udostępnisz aplikację użytkownikom, musisz skonfigurować dostawcę atestów produkcyjnych (np. App Attest, Play Integrity lub reCAPTCHA Enterprise), aby użytkownicy mogli korzystać z funkcji AI, gdy App Check jest egzekwowane.
Błąd 403: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
Jeśli pojawi się błąd 403 - PERMISSION_DENIED, który informuje, żeFirebase AI Logic has been deactivated in this project. To resume using
Firebase AI Logic, you must enforce Firebase App Check. Learn more:
https://firebase.google.com/docs/ai-logic/app-check, oznacza to, że Twój projekt w Firebase został uznany za nieaktywny i nie masz włączonego App Check w przypadku Firebase AI Logic.
„Nieaktywne projekty” to te, w których jest włączona usługa Firebase AI Logic, ale nie są one ostatnio używane w ramach Firebase AI Logic.
Ponieważ w przypadku usługi Firebase AI Logic nie masz włączonej funkcji App Check, Twój projekt jest narażony na nadużycia związane z usługą Gemini API. Aby chronić Twój projekt, Firebase wyłączył korzystanie z usługi Firebase AI Logic, dopóki nie wymusisz App Check w przypadku Firebase AI Logic.
Gdy zechcesz ponownie użyć Firebase AI Logic, wykonaj te czynności:
Skonfiguruj App Check dla Firebase AI Logic. W przypadku programowania lokalnego skonfiguruj App Check dostawcę debugowania.
Egzekwowanie App Check ma kluczowe znaczenie dla ochrony Gemini API i Gemini przed nadużyciami. Aby usunąć ten błąd, musisz egzekwować te zasady.
Ponownie wyślij prośbę z aplikacji do Firebase AI Logic.
To żądanie wyśle prawidłowy token App Check i nie będzie już zwracać błędu
403 - PERMISSION_DENIED.Jeśli wymagasz już App Check i nadal widzisz ten błąd, sprawdź, czy ochrona przed powtórzeniem jest włączona w przypadku Firebase AI Logic (również w trybie „Tylko monitorowanie”).
Gdy ochrona przed powtórzeniem jest włączona, tylko tokeny ograniczonego użytku są uznawane za zweryfikowane w przypadku Firebase AI Logic. Zwykłe tokeny sesji nie usuwają tego błędu. Możesz włączyć w aplikacji tokeny ograniczonego użytku lub wyłączyć ochronę przed powtórzeniem w przypadku Firebase AI Logic, ponownie wysłać żądanie i poczekać około dnia, zanim ponownie włączysz ochronę przed powtórzeniem (aktywność projektu jest ponownie oceniana codziennie).
Zanim udostępnisz aplikację użytkownikom, musisz skonfigurować dostawcę atestów produkcyjnych (np. App Attest, Play Integrity lub reCAPTCHA Enterprise), aby użytkownicy mogli korzystać z funkcji AI, gdy App Check jest egzekwowane.
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/obiekcie konfiguracji Firebase należy do innego projektu w Firebase.
Sprawdź, czy klucz interfejsu API wymieniony w pliku/obiekcie konfiguracji 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ą, uzyskaj 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 aplikacji i projektu w 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 konsoliGoogle 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 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 404: Firebase AI Logic genai config not found
Jeśli pojawi się błąd 404 z komunikatem Firebase AI Logic genai config not found, zwykle oznacza to, że ustawienie Firebase AI Logic jest nieprawidłowo skonfigurowane lub brakuje go.
Oto najbardziej prawdopodobne przyczyny tego błędu:
Nie masz jeszcze skonfigurowanego projektu Firebase dla dostawcy Gemini API.
Co zrobić:
W konsoli Firebase otwórz Usługi AI > Logika AI. Kliknij Rozpocznij, a następnie wybierz wybranego dostawcę Gemini API. Włącz interfejs API, a Firebase skonfiguruje projekt pod kątem tego dostawcy. Po zakończeniu przepływu pracy spróbuj ponownie wykonać żądanie.Jeśli niedawno przeszedłeś(-aś) proces konfiguracji Firebase AI Logic w konsoli Firebase, konfiguracja Firebase AI Logic może nie być jeszcze dostępna dla wszystkich wymaganych usług backendu we wszystkich odpowiednich regionach.
Co zrobić:
Odczekaj kilka minut i spróbuj ponownie.
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.”
Taki błąd może pojawić się z kilku powodów.
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ępny tylko w wersji podglądowej) - Najnowsza Gemini 3.x Flash
nazwa modelu:
gemini-3.8-flash - Najnowsza Gemini 3.x Flash‑Lite
nazwa modelu:
gemini-3.5-flash-lite - Nazwa najnowszego modelu Gemini 3.x Pro Image (czyli „Nano Banana Pro”):
gemini-3-pro-image - Najnowsza wersja Gemini 3.x Flash Image (czyli „Nano Banana 2”)
nazwa modelu:
gemini-3.1-flash-image - Najnowsza wersja Gemini 3.x Flash‑Lite Image (znana też jako „Nano Banana 2 Lite”)
nazwa modelu:
gemini-3.1-flash-lite-image - Najnowsza wersja Gemini 2.5 Flash Image (czyli „Nano Banana”)
nazwa modelu:
gemini-2.5-flash-image
- Nazwa najnowszego modelu Gemini 3.x Pro:
Nieprawidłowa lokalizacja (dotyczy tylko dostawcy Agent Platform Gemini API (formerly Vertex AI))
Przyczyna: Twoja prośba może próbować uzyskać dostęp 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.
Podczas korzystania z funkcji Agent Platform Gemini API (formerly Vertex AI) możesz opcjonalnie określić lokalizację, z której model będzie dostępny podczas inicjowania. Jeśli nie określisz lokalizacji, domyślnie Firebase AI Logic będzie używać tych lokalizacji:
- Jeśli używasz składni inicjowania „Agent Platform”:
global - Jeśli używasz starszej składni inicjowania „Vertex AI”:
us-central1
Jednak nie wszystkie modele są obsługiwane w tych domyślnych lokalizacjach. Oznacza to, że w zależności od modelu podczas inicjowania może być konieczne wyraźne ustawienie konkretnej lokalizacji.
Gemini Modele w wersji testowej i eksperymentalne: dostępne tylko w
global.Gemini 3.x modele stabilne: dostępne w
global, a często także wusieu.Modele Gemini 2.5: dostępne w wielu lokalizacjach. Pamiętaj, że modele Gemini Live API 2.5 nie są dostępne w
global.
- Jeśli używasz składni inicjowania „Agent Platform”:
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."
Taki błąd może pojawić się z kilku powodów.
Przekraczasz limit lub model, do którego masz 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 Agent Platform Gemini API (formerly Vertex AI). Więcej informacji o limitach i sposobie wysyłania próśb o dodatkowe limity znajdziesz w sekcji Limity szybkości i limity.
Jeśli używasz Agent Platform Gemini API (formerly Vertex AI), w Google Clouddokumentacji znajdziesz dodatkowe informacje i wskazówki dotyczące kodu błędu 429.
Próbujesz użyć modelu lub funkcji, które wymagają płatności, ale Twój projekt w Firebase korzysta z abonamentu Spark.
Jeśli korzystasz z Gemini Developer API, możesz uzyskać ograniczony dostęp do niektórych modeli i wielu podstawowych funkcji w ramach Gemini Developer API „poziomu bezpłatnego”. Ten poziom umożliwia rozpoczęcie pracy bez konieczności podawania formy płatności, co oznacza, że nie musisz przechodzić na abonament Blaze z płatnością za wykorzystanie.
Niektóre modele nie są dostępne w Gemini Developer API„poziomie bezpłatnym” i wymagają „wersji płatnej”, co oznacza, że Twój projekt musi korzystać z abonamentu Blaze z płatnością według wykorzystania. Na przykład te modele prawie zawsze wymagają płatności:
- Większość modeli wersji podglądowej i eksperymentalnych
- Modele generujące obrazy (modele „Nano Banana”)
Niektóre modele oferują podstawowe funkcje w ramach Gemini Developer API „bezpłatnej wersji”, ale aby korzystać z bardziej zaawansowanych funkcji, wymagają „wersji płatnej”. Przykład:
- W przypadku większości modeli Gemini 3.x
uziemienie za pomocą
Google Search lubGoogle Maps wymaga płatności.
- W przypadku większości modeli Gemini 3.x
uziemienie za pomocą
Dowiedz się więcej o abonamentach Firebase i Gemini Developer API.
Więcej informacji znajdziesz w Gemini Developer API dokumentacji dotyczącej cen oraz w najczęstszych pytaniach dotyczących rozliczeń.