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 się nie zgadzają, 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 dla 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 tym, że w projekcie nie zostały automatycznie udostępnione wymagane agenty usługi gdy w projekcie włączono interfejs Vertex AI API. Jest to znany problem w przypadku niektórych projektów i pracujemy nad jego globalnym rozwiązaniem.

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 interfejsu gcloud CLI i uwierzytelnij się w nim.
   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 interfejs 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 w projekcie wymagane agenty 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 ''
   

4. Poczekaj kilka minut, aż agenty usługi zostaną udostępnione, a następnie spróbuj ponownie wysłać żądanie multimodalne zawierające 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: 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łanie 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 ma 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. Upewnij się, że wybrana jest opcja Ogranicz klucz. Jeśli nie jest, Twój klucz nie ma ograniczeń i prawdopodobnie nie jest to źródło 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.

   Wprowadzenie 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 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 się nie zgadzają, 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 dla Twojej aplikacji i projektu w Firebase.

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

Jeśli próbujesz użyć Gemini Developer API i otrzymasz błąd 404 z komunikatem Firebase AI Logic genai config not found, zwykle oznacza to, że Twój projekt w Firebase nie ma prawidłowego klucza interfejsu Gemini API do użycia z pakietami SDK klienta Firebase AI Logic.

Oto najczęstsze przyczyny tego błędu:

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

  Co zrobić:
  W konsoli Firebase otwórz stronę Firebase AI Logic. Kliknij Rozpocznij, a następnie wybierz Gemini Developer API. Włącz interfejs API, a konsola skonfiguruje Twój projekt pod kątem Gemini Developer API. Po zakończeniu procesu spróbuj ponownie wysłać żądanie.

• Jeśli niedawno przeszedłeś proces konfiguracji Firebase AI Logic w konsoli Firebase, klucz interfejsu Gemini API może nie być jeszcze dostępny dla wszystkich wymaganych usług backendu we wszystkich regionach.

  Co zrobić:
  Poczekaj kilka minut, a następnie spróbuj ponownie wysłać żądanie.

• Klucz interfejsu Gemini API mógł zostać usunięty z Twojego projektu w Firebase.

  Co zrobić:
  Dowiedz się, jak zmienić klucz interfejsu Gemini API używany przez Firebase AI Logic.

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-pro-image-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 powodów.

• Nieprawidłowa nazwa modelu

  • Przyczyna: podana nazwa modelu jest nieprawidłowa.

  • Rozwiązanie: sprawdź, czy nazwa i wersja modelu znajdują się na liście wszystkich obsługiwanych i dostępnych modeli. Sprawdź segmenty i ich kolejność w nazwie modelu. Przykład:

    • Nazwa modelu w wersji zapoznawczej Gemini 3.1 Pro to gemini-3.1-pro-preview.
    • Nazwa modelu w wersji zapoznawczej Gemini 3 Flash to gemini-3-flash-preview.
    • Nazwa modelu w wersji zapoznawczej „Nano Banana Pro” to gemini-3-pro-image-preview.
    • Nazwa modelu w wersji zapoznawczej „Nano Banana 2” to gemini-3.1-flash-image-preview.
    • Nazwa modelu „Nano Banana” to gemini-2.5-flash-image.

• Nieprawidłowa lokalizacja (dotyczy tylko używania dostawcy Vertex AI Gemini API i modelu w wersji testowej lub eksperymentalnej)

  • Przyczyna: używasz wersji zapoznawczej lub eksperymentalnej modelu (np. gemini-3.1-pro-preview i gemini-3.1-flash-image-preview) i nie określiłeś lokalizacji global .

    Jeśli używasz Vertex AI Gemini API, wszystkie wersji zapoznawczej i eksperymentalnej Gemini modele (z wyjątkiem modeli Gemini Live) są tylko dostępne w lokalizacji global. Ponieważ jednak Firebase AI Logic domyślnie używa lokalizacji us-central1, musisz wyraźnie określić lokalizację global podczas inicjowania usługi backendu Vertex AI Gemini API w kodzie, gdy używasz tych modeli w wersji zapoznawczej i eksperymentalnej Gemini.

  • Rozwiązanie: podczas inicjowania usługi Vertex AI Gemini API określ lokalizację global. Dowiedz się więcej o określaniu lokalizacji na potrzeby uzyskiwania dostępu do modelu (w tym o fragmentach kodu).

• Nieprawidłowa lokalizacja (dotyczy tylko używania dostawcy Vertex AI Gemini API)

  • Przyczyna: używasz modelu, który nie jest obsługiwany w lokalizacji, w której próbujesz uzyskać do niego dostęp.

    Jeśli używasz Vertex AI Gemini API, niektóre modele są dostępne tylko w określonych lokalizacjach. Na przykład (ale nie tylko):

    • Modele Imagen nie są obsługiwane w lokalizacji global.
    • Gemini Live API modele (np. gemini-2.0-flash-live-preview-04-09) są tylko obsługiwane w lokalizacji us-central1 .
    • Modele Gemini 2.5 (np. gemini-2.5-pro) są tylko dostępne w lokalizacji global, lokalizacjach w Stanach Zjednoczonych i niektórych lokalizacjach w Europie (a czasami w innych lokalizacjach, jeśli Twój projekt ma specjalne opcje).

  • Rozwiązanie: podczas inicjowania usługi Vertex AI Gemini API upewnij się, że określasz obsługiwaną lokalizację dla używanego modelu. Dowiedz się więcej o określaniu lokalizacji na potrzeby uzyskiwania dostępu do modelu (w tym o fragmentach kodu) oraz o obsługiwanych lokalizacjach modeli.

    Pamiętaj, że Firebase AI Logic domyślnie używa lokalizacji us-central1.

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 od innych osób.

Dalsze działania zależą od tego, czy używasz Gemini Developer API czy Vertex AI Gemini API. Więcej informacji o limitach i o tym, jak poprosić o zwiększenie limitu, znajdziesz w sekcji Limity i limity.

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