Kody błędów

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 Twoją aplikacją lub projektem w Firebase.

Sprawdź, czy klucz interfejsu API wymieniony w pliku lub obiekcie konfiguracji Firebase jest zgodny z kluczem interfejsu API Twojej aplikacji. Wszystkie klucze interfejsu API możesz wyświetlić w Interfejsy API i usługi > Dane logowania panelu w Google Cloud konsoli.

Jeśli okaże się, że klucze nie są zgodne, to pobierz nowy plik lub obiekt konfiguracji Firebase, a następnie zastąp nim ten, który znajduje się w Twojej aplikacji. Nowy plik lub obiekt konfiguracji powinien zawierać prawidłowy klucz interfejsu API Twojej 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 Cloud Storage for Firebase URL, może wystąpić 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 projektem, w którym wymagane agenty usługi nie zostały prawidłowo automatycznie udostępnione, gdy w projekcie włączono interfejs Agent Platform API. Jest to znany problem w przypadku niektórych projektów, nad którym pracujemy.

Oto obejście, które pozwoli naprawić projekt i prawidłowo udostępnić te agenty usługi , aby można było zacząć uwzględniać adresy URL Cloud Storage for Firebase w żądaniach multimodalnych. Musisz być właścicielem projektu i wykonać ten zestaw zadań tylko raz.

1. Uzyskaj dostęp do gcloud CLI i uwierzytelnij się.
   Najłatwiej to zrobić w Cloud Shell. Więcej informacji znajdziesz w Google Cloud dokumentacji.

2. Jeśli pojawi się prośba, postępuj zgodnie z instrukcjami wyświetlanymi w terminalu, aby gcloud CLI działał w Twoim projekcie w Firebase.

   Będziesz potrzebować identyfikatora projektu w Firebase, który znajdziesz u góry settings Ustawienia projektu w konsoli Firebase.

3. Udostępnij wymagane agenty usługi w projekcie, 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 ''
   

4. Poczekaj kilka minut, aż agenty usługi zostaną udostępnione, a następnie spróbuj ponownie wysłać żądanie multimodalne, które zawiera Cloud Storage for Firebase adres URL.

Jeśli po kilku minutach nadal występuje 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 z komunikatem 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 zostały zidentyfikowane jako często nadużywane przez złośliwych użytkowników.

Ponieważ nie masz włączonej funkcji App Check w Firebase AI Logic, Twój projekt jest podatny na nadużycia tych modeli. Aby chronić deweloperów, Firebase blokuje dostęp do tych modeli, chyba że żądanie zawiera prawidłowy App Check token (co oznacza, że App Check jest włączona w Firebase AI Logic).

Jeśli chcesz uzyskać dostęp do modelu, który zwrócił błąd, wykonaj te czynności:

1. Skonfiguruj App Check w Firebase AI Logic. W przypadku programowania lokalnego skonfiguruj App Check dostawcę debugowania.

   Egzekwowanie App Check jest niezbędne, aby chronić Gemini API i Gemini modele przed nadużyciami. Jest to też wymagane, aby rozwiązać ten błąd.

2. Ponownie wyślij żądanie z aplikacji do Firebase AI Logic.

   To żądanie wyśle prawidłowy App Check token i nie będziesz już otrzymywać błędu 403 - PERMISSION_DENIED.

3. 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 włączona.

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 otrzymasz błąd 403 - PERMISSION_DENIED z komunikatem 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, oznacza to, że Twój projekt w Firebase został oznaczony jako nieaktywny i nie masz włączonej funkcji App Check w Firebase AI Logic.

„Nieaktywne projekty” to te, w których włączono Firebase AI Logic, ale nie są one ostatnio używane Firebase AI Logic.

Ponieważ nie masz włączonej funkcji App Check w Firebase AI Logic, Twój projekt jest podatny na nadużycia interfejsu Gemini API. Aby chronić Twój projekt, Firebase wyłączył korzystanie z Firebase AI Logic, dopóki nie włączysz funkcji App Check w Firebase AI Logic.

Gdy będziesz gotowy(-a) do ponownego korzystania z Firebase AI Logic, wykonaj te czynności:

1. Skonfiguruj App Check w Firebase AI Logic. W przypadku programowania lokalnego skonfiguruj App Check dostawcę debugowania.

   Egzekwowanie App Check jest niezbędne, aby chronić Gemini API i Gemini modele przed nadużyciami. Jest to też wymagane, aby rozwiązać ten błąd.

2. Ponownie wyślij żądanie z aplikacji do Firebase AI Logic.

   To żądanie wyśle prawidłowy App Check token i nie będziesz już otrzymywać błędu 403 - PERMISSION_DENIED.

3. 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 włączona.

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 w Firebase.

Sprawdź, czy klucz interfejsu API wymieniony w pliku lub obiekcie konfiguracji Firebase jest zgodny z kluczem interfejsu API Twojej aplikacji. Wszystkie klucze interfejsu API możesz wyświetlić w Interfejsy API i usługi > Dane logowania panelu w Google Cloud konsoli.

Jeśli okaże się, że klucze nie są zgodne, to pobierz nowy plik lub obiekt konfiguracji Firebase, a następnie zastąp nim ten, który znajduje się w Twojej aplikacji. Nowy plik lub obiekt konfiguracji powinien zawierać prawidłowy klucz interfejsu API Twojej 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 Twojej aplikacji ma ograniczenia, które uniemożliwiają wywoływanie wymaganego interfejsu API.

Aby rozwiązać ten problem, musisz zaktualizować ograniczenia klucza interfejsu API w Google Cloud konsoli, aby uwzględnić wymagany interfejs API. W przypadku Firebase AI Logic, musisz się upewnić, że Firebase AI Logic interfejs API (firebasevertexai.googleapis.com) jest uwzględniony na liście wybranych interfejsów API, które można wywoływać za pomocą klucza interfejsu API.

Aby to zrobić:

1. W konsoli Google Cloud otwórz panel Interfejsy API i usługi > Dane logowania.

2. Wybierz klucz interfejsu API, którego używa Twoja aplikacja (np. „klucz iOS” w przypadku aplikacji na iOS).

3. Na stronie Edytuj klucz interfejsu API znajdź sekcję Ograniczenia interfejsów API.

4. Sprawdź, czy wybrana jest opcja Ogranicz klucz. Jeśli nie, klucz nie jest ograniczony i prawdopodobnie nie jest to przyczyną błędu.

5. W menu Wybrane interfejsy API wyszukaj i wybierz Firebase AI Logic interfejs API, aby dodać go do listy wybranych interfejsów API, które można wywoływać za pomocą klucza interfejsu API.

6. Kliknij Zapisz.

   Zastosowanie zmian może potrwać do 5 minut.

Błąd 404: Firebase AI Logic genai config not found

Jeśli otrzymasz błąd 404 z komunikatem Firebase AI Logic genai config not found, zwykle oznacza to, że ustawienie dla Firebase AI Logic jest nieprawidłowo skonfigurowane lub brakuje go.

Oto najczęstsze przyczyny tego błędu:

• Projekt Firebase nie został jeszcze skonfigurowany pod kątem dostawcy Gemini API.

  Co zrobić:
  W konsoli Firebaseotwórz Usługi AI > AI Logic. Kliknij Rozpocznij, a następnie wybierz wybranego Gemini API dostawcę. Włącz interfejs API, a Firebase skonfiguruje Twój projekt pod kątem tego dostawcy. Po zakończeniu procesu spróbuj ponownie wysłać żądanie.

• Jeśli niedawno przeprowadzono 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ć:
  Poczekaj kilka minut, a następnie spróbuj ponownie wysłać żądanie.

Błąd 404: the 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.”

Ten błąd może wystąpić z kilku różnych powodów.

• Nieprawidłowa nazwa modelu

  • Przyczyna: podana nazwa modelu jest nieprawidłowa.

  • Rozwiązanie: sprawdź, czy nazwa modelu i jego wersja są zgodne z listą 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 testowej)
    • Nazwa najnowszego modelu Gemini 3.x Flash: gemini-3.7-flash
    • Nazwa najnowszego modelu Gemini 3.x Flash‑Lite: gemini-3.5-flash-lite
    • Nazwa najnowszego modelu Gemini 3.x Pro Image (znanego też jako "Nano Banana Pro") : gemini-3-pro-image
    • Nazwa najnowszego modelu Gemini 3.x Flash Image (znanego też jako "Nano Banana 2") : gemini-3.1-flash-image
    • Nazwa najnowszego modelu Gemini 3.x Flash‑Lite Image (znanego też jako "Nano Banana 2 Lite") : gemini-3.1-flash-lite-image
    • Nazwa najnowszego modelu Gemini 2.5 Flash Image (znanego też jako "Nano Banana") : gemini-2.5-flash-image

• Nieprawidłowa lokalizacja (dotyczy tylko korzystania z dostawcy Agent Platform Gemini API (formerly Vertex AI))

  • Przyczyna: Twoje żądanie może próbować uzyskać dostęp do modelu w lokalizacji w której model nie jest dostępny.

  • Rozwiązanie: upewnij się, że Twoje żądanie próbuje uzyskać dostęp do modelu w miejscu, w którym jest on dostępny.

    Gdy używasz Agent Platform Gemini API (formerly Vertex AI), podczas inicjowania możesz opcjonalnie określić lokalizację, w której chcesz uzyskać dostęp do modelu. Jeśli nie określisz lokalizacji, Firebase AI Logic domyślnie użyje tych lokalizacji:

    • W przypadku używania składni inicjowania „Agent Platform”: global
    • W przypadku używania 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ć wymagane wyraźne ustawienie konkretnej lokalizacji.

    • Gemini Modele w wersji testowej i eksperymentalnej: dostępne tylko w lokalizacji global

    • Gemini 3.x modele stabilne: dostępne w lokalizacji global oraz często w lokalizacjach us i eu.

    • Gemini 2.5 modele: dostępne w wielu lokalizacjach. Pamiętaj, że Gemini Live API 2.5 modele nie są dostępne w lokalizacji global.

  Więcej informacji o tym, jak określić lokalizację, w której chcesz uzyskać dostęp 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."

Ten błąd może wystąpić z kilku różnych powodów.

• Przekraczasz limit lub model, do którego uzyskujesz dostęp, jest przeciążony żądaniami od 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 o tym, jak poprosić o zwiększenie limitu, znajdziesz w sekcji Limity i limity.

  Jeśli używasz Agent Platform Gemini API (formerly Vertex AI), w Google Cloud dokumentacji znajdziesz dodatkowe informacje i wskazówki dotyczące kodu błędu 429.

• Próbujesz użyć modelu lub funkcji, która wymaga płatności, ale Twój projekt w Firebase korzysta z abonamentu Spark.

  Jeśli używasz Gemini Developer API, możesz uzyskać ograniczony dostęp do niektórych modeli i dostęp do wielu podstawowych funkcji w ramach Gemini Developer API „poziomu bezpłatnego”. Ten poziom pozwala rozpocząć korzystanie z interfejsu bez konieczności podawania formy płatności, co oznacza, że nie musisz przechodzić na abonament Blaze z płatnością według wykorzystania.

  • Niektóre modele nie są dostępne w ramach Gemini Developer API „poziomu bezpłatnego” i wymagają „poziomu płatnego”, 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 w wersji testowej i eksperymentalnej
    • Modele generujące obrazy (modele „Nano Banana”)

  • Niektóre modele oferują podstawowe funkcje w ramach Gemini Developer API "poziomu bezpłatnego", ale do korzystania z bardziej zaawansowanych funkcji wymagają "poziomu płatnego" . Przykład:

    • W przypadku większości modeli Gemini 3.x funkcja Grounding z Google Search lub Google Maps wymaga płatności.

  Więcej informacji o abonamentach Firebase i Gemini Developer API.

  Więcej informacji znajdziesz w Gemini Developer API dokumentacji cennika i najczęstszych pytaniach dotyczących płatności.