Najczęstsze pytania i rozwiązywanie problemów

iOS+ Android Sieć Flutter

Na tej stronie znajdziesz odpowiedzi na najczęstsze pytania dotyczące pakietów SDK Gemini API i Vertex AI in Firebase. Więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania dotyczące Gemini API w dokumentacji Google Cloud.

Które interfejsy API należy włączyć, aby korzystać z pakietów SDK Vertex AI in Firebase? Jak je włączyć?

Aby używać pakietów SDK Vertex AI in Firebase, musisz włączyć w projekcie te 2 interfejsy API:

• Vertex AI API (aiplatform.googleapis.com)
• Vertex AI in Firebase API (firebasevertexai.googleapis.com)

Możesz włączyć te interfejsy API za pomocą kilku kliknięć w konsoli Firebase:

1. Otwórz stronę Kompilacja za pomocą Gemini.

2. Kliknij kartę Vertex AI in Firebase, aby uruchomić przepływ pracy, który włącza te 2 interfejsy API. W ramach tego procesu interfejs API Vertex AI in Firebase zostanie też dodany do listy dozwolonych kluczy interfejsu API Firebase.

Możesz też użyć konsoli Google Cloud (opcja bardziej ręczna):

1. Kliknij link do każdego interfejsu API u góry tego artykułu z najczęściej zadawanymi pytaniami, a potem na stronie każdego interfejsu API kliknij Włącz.

2. Dodaj interfejs API Vertex AI in Firebase do listy dozwolonych kluczy interfejsu API Firebase, wykonując instrukcje podane w sekcji Dodawanie ograniczeń interfejsu API w dokumentacji Google Cloud.

Uwaga: wersja podglądu interfejsu Vertex AI in Firebase wymaga interfejsu Firebase ML API (firebaseml.googleapis.com), ale nie jest on wymagany teraz, gdy interfejs Vertex AI in Firebase jest dostępny ogólnie (GA).

Jakich uprawnień wymagają pakiety SDK Vertex AI in Firebase?

Czynność	Wymagane uprawnienia	Role uprawnień, które domyślnie zawierają wymagane uprawnienia
Przejście na abonament Blaze z płatnościami według wykorzystania	firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment	Właściciel
Włączanie interfejsów API w projekcie	serviceusage.services.enable	Edytujący Właściciel
Tworzenie aplikacji Firebase	firebase.clients.create	Administrator Firebase Edytujący Właściciel

Których modeli można używać z pakietami SDK Vertex AI in Firebase?

• Z pakietami SDK Vertex AI in Firebase możesz używać dowolnych modeli podstawowych Gemini. Listę tych modeli znajdziesz w artykule Więcej informacji o modelach Gemini.

  Możesz zacząć eksperymentować z modelem Gemini 2.0 (gemini-2.0-flash-exp) za pomocą pakietów SDK Vertex AI in Firebase.
  Obecnie nasze pakiety SDK obsługują dane tekstowe pochodzące z tekstu, kodu, obrazu, PDF-a, dźwięku, filmu i filmu z dźwiękiem. W 2025 r. udostępnimy obsługę interfejsu Multimodal Live API oraz natywnego wyjścia dźwięku i obrazu.

• Nie możesz używać z pakietami SDK Vertex AI in Firebase modeli Gemini, które nie są modelami podstawy (np. modeli PaLM, modeli zoptymalizowanych lub modeli opartych na Gemma).

Często dodajemy do zestawów SDK nowe funkcje, dlatego sprawdzaj tę stronę z odpowiadaniami na najczęstsze pytania (a także informacje o wersji, blogi i posty w mediach społecznościowych).

Jak ustawić limit szybkości na użytkownika?

Domyślnie Vertex AI in Firebase ustawia limit żądań na użytkownika na 100 żądań na minutę (RPM).

Jeśli chcesz dostosować limit szybkości na użytkownika, musisz dostosować ustawienia limitu interfejsu API Vertex AI in Firebase.

Dowiedz się więcej o Vertex AI in Firebase limitach interfejsu API. Na tej stronie możesz też dowiedzieć się, jak wyświetlić i edytować limit.

Jak naprawić 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 za pomocą adresu URL Cloud Storage for Firebase, możesz napotkać 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 utworzone wymagane agenty usług, gdy włączono w nim interfejs API Vertex AI. Jest to znany problem z niektórymi projektami. Pracujemy nad globalnym rozwiązaniem.

Oto obejście, które pozwoli Ci poprawić projekt i prawidłowo skonfigurować tych agentów usług, aby można było uwzględniać adresy URL Cloud Storage for Firebase w żądaniach multimodalnych. Musisz być właścicielem projektu. Wystarczy, że wykonasz ten zestaw zadań tylko raz.

1. Uzyskaj dostęp i uwierzytelnij się za pomocą usługi gcloud CLI.
   Najłatwiej zrobić to z poziomu Cloud Shell. Więcej informacji znajdziesz w Google Clouddokumentacji.

2. Jeśli pojawi się monit, postępuj zgodnie z instrukcjami wyświetlanymi na terminalu, aby wykonać polecenie gcloud CLI w projekcie Firebase.

   Potrzebujesz identyfikatora projektu Firebase, który znajdziesz u góry strony Ustawienia projektu w konsoli Firebase.

3. Włącz wymagane usługi agentów 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. Zaczekaj kilka minut, aby upewnić się, że agenci obsługi klienta są dostępni, a następnie ponownie wyślij żądanie multimodalne zawierające adres URL Cloud Storage for Firebase.

Jeśli po kilku minutach nadal widzisz ten błąd, skontaktuj się z zespołem pomocy Firebase.

Jak naprawić błąd 400? API key not valid. Please pass a valid API key.

Jeśli otrzymasz błąd 400 z komunikatemAPI key not valid. Please pass a valid API key., oznacza to zwykle, że klucz API w pliku lub obiekcie konfiguracji Firebase nie istnieje lub nie jest skonfigurowany do użycia z aplikacją lub projektem Firebase.

Sprawdź, czy klucz API podany w pliku konfiguracyjnym lub obiekcie Firebase jest zgodny z kluczem API Twojej aplikacji. Wszystkie klucze 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 są one zgodne, pobierz nowy plik lub obiekt konfiguracji Firebase, a potem zastąp nim ten, który jest w aplikacji. Nowy plik lub obiekt konfiguracji powinien zawierać prawidłowy klucz API dla Twojej aplikacji i Twojego projektu Firebase.

Jak naprawić błąd 403? Requests to this API firebasevertexai.googleapis.com ... are blocked.

Jeśli widzisz błąd 403 z wiadomością Requests to this API firebasevertexai.googleapis.com ... are blocked., zwykle oznacza to, że klucz interfejsu API w pliku konfiguracyjnym/obiekcie Firebase nie ma na liście dozwolonych interfejsów API dla usługi, której próbujesz używać.

Upewnij się, że klucz interfejsu API używany przez Twoją aplikację zawiera wszystkie wymagane interfejsy API uwzględnione na liście dozwolonych „ograniczeń interfejsu API” klucza. W przypadku Vertex AI in Firebase klucz interfejsu API musi zawierać co najmniej interfejs API Vertex AI in Firebase na liście dozwolonych.

Wszystkie klucze interfejsu API znajdziesz w panelu Interfejsy API i usługi > Dane logowania w konsoli Google Cloud.

Uwaga: interfejsy API związane z Firebase używają kluczy API tylko do identyfikowania projektu lub aplikacji Firebase, a nie do autoryzacji wywołania interfejsu API (jak to umożliwiają niektóre inne interfejsy API). Autoryzacja interfejsów API związanych z Firebase jest obsługiwana niezależnie od klucza interfejsu API, za pomocą uprawnień Google Cloud, Firebase Security Rules lub Firebase App Check. Dowiedz się więcej o kluczach interfejsu API Firebase.

Jak naprawić błąd 403? PERMISSION_DENIED: The caller does not have permission.

Jeśli otrzymasz błąd 403 z wiadomością PERMISSION_DENIED: The caller does not have permission., oznacza to zwykle, że klucz interfejsu API w pliku lub obiekcie konfiguracji Firebase należy do innego projektu Firebase.

Sprawdź, czy klucz API podany w pliku konfiguracyjnym lub obiekcie Firebase jest zgodny z kluczem API Twojej aplikacji. Wszystkie klucze 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 są one zgodne, pobierz nowy plik lub obiekt konfiguracji Firebase, a potem zastąp nim ten, który jest w aplikacji. Nowy plik lub obiekt konfiguracji powinien zawierać prawidłowy klucz API dla Twojej aplikacji i Twojego projektu Firebase.

Prześlij opinię o tym, jak oceniasz korzystanie z usługi Vertex AI in Firebase