SSS ve sorun giderme

Bu sayfada, Gemini API ve Firebase AI Logic SDK'ları hakkında sık sorulan soruların (SSS) yanıtları ve sorun giderme bilgileri yer almaktadır. Diğer sorularınız için Google Cloud belgelerindeki Gemini API SSS bölümüne göz atın.

Firebase AI Logic ve istemci SDK'ları daha önce "Vertex AI in Firebase" olarak adlandırılıyordu. Mayıs 2025'te, genişletilmiş hizmetlerimizi ve özelliklerimizi daha iyi yansıtmak için hizmetlerimizi yeniden adlandırıp Firebase AI Logic olarak yeniden paketledik. Örneğin, artık Gemini Developer API'ü destekliyoruz.

Durum kontrol panelleri

• Firebase AI Logic

• Gemini Developer API

• Vertex AI Gemini API (Vertex Gemini API ve Vertex Imagen API)

Genel SSS

Ad neden "Vertex AI in Firebase"dan "Firebase AI Logic" olarak değişti?

2024'te, Vertex AI Gemini API kullanabilen bir dizi Firebase istemci SDK'sı ve bu API'yi kötüye kullanıma karşı korumak ve diğer Firebase ürünleriyle entegrasyonları etkinleştirmek için bir Firebase proxy ağ geçidi kullanıma sunduk. Ürünümüze "Firebase'de Vertex AI" adını verdik. Bu ürün adı, ürünümüzün o dönemdeki mevcut kullanım alanlarını doğru bir şekilde tanımlıyordu.

Ancak o zamandan beri ürünümüzün özelliklerini genişlettik. Örneğin, Mayıs 2025 itibarıyla Gemini Developer API için destek sunuyoruz. Firebase App Check ile entegrasyonumuz sayesinde Gemini Developer API'yı kötüye kullanıma karşı koruyabilirsiniz.

Bu nedenle, "Firebase'de Vertex AI" adı artık ürünümüzün genişletilmiş kapsamını doğru şekilde temsil etmiyor. Bu nedenle, yeni bir ad olan Firebase AI Logic, gelişen özellik setimizi daha iyi yansıtıyor ve gelecekte tekliflerimizi genişletmeye devam etmemize olanak tanıyor.

Firebase AI Logic'daki en yeni özelliklerden yararlanmak (ve isterseniz Gemini Developer API'ı kullanmaya başlamak) için taşıma kılavuzuna göz atın.

Gemini Developer API ve Vertex AI Gemini API kullanmak arasındaki farklar nelerdir?

İki "Gemini API" sağlayıcı arasındaki bazı farklar aşağıda belirtilmiştir (genel olarak, bunlara nasıl eriştiğinizden bağımsız olarak):

• Fiyatlandırma

  • Gemini Developer API, kullandıkça öde fiyatlandırmasıyla birlikte "ücretsiz katman" sunar.

  • Vertex AI Gemini API, Firebase AI Logic ile birlikte kullanıldığında her zaman kullandıkça öde Blaze fiyatlandırma planını gerektirir.

  İki API sağlayıcının farklı kullandıkça öde fiyatlandırması olduğunu unutmayın (ilgili dokümanlarından daha fazla bilgi edinebilirsiniz).

• Hız sınırları (kota)

  • Gemini Developer API için açıkça belirtilmiş sıklık sınırları vardır.

  • Vertex AI Gemini API, bölgedeki bu modeli kullanan herkesin paylaştığı "dinamik paylaşılan kota (DSQ)" özelliğini kullanır. İsteğe bağlı olarak, sağlanan işleme hızı (PT) da ayarlayabilirsiniz.

• Modele erişilecek konumu belirtme

  • Yalnızca Vertex AI Gemini API simgesi, modele eriştiğiniz konumu seçmenize olanak tanır.

Aşağıdaki tabloda, iki "Gemini API" sağlayıcısı için sık sorulan özelliklerin kullanılabilirliği listelenmiştir. Bu tablo özellikle Firebase AI Logic istemci SDK'ları kullanılırken geçerlidir.

Özellik	Gemini Developer API	Vertex AI Gemini API
Gemini modelleri için destek	desteklenir	desteklenir
Imagen modelleri için destek	destekleniyor (Unity için henüz kullanılamaz)	destekleniyor (Unity için henüz kullanılamaz)
Veo modelleri için destek	Henüz desteklenmiyor.	henüz desteklenmiyor
Gemini Live API için destek	Henüz desteklenmiyor.	desteklenir (yalnızca Android, Flutter ve Unity)
Firebase App Check ile entegrasyon	desteklenir	desteklenir
Firebase Remote Config ile uyumlu	desteklenir	desteklenir
Firebase konsolundayapay zeka izleme desteği	Henüz desteklenmiyor.	desteklenir
Cloud Storage URL'leri için destek	henüz desteklenmiyor ^1	Herkese açık dosyalar ve Firebase Security Rules ile korunan dosyalar
YouTube URL'leri ve tarayıcı URL'leri için destek	Yalnızca YouTube URL'leri	YouTube URL'leri ve Tarayıcı URL'leri

¹ Gemini Developer API için Files API, Firebase AI Logic SDK'ları üzerinden desteklenmez.

Not: Firebase AI Logic kullanılırken aşağıdaki özellikler henüz desteklenmemektedir: bağlam önbelleğe alma, araç olarak arama, Google Arama ile temellendirme, kod yürütme, modelde ince ayar yapma, gömme oluşturma, anlamsal alma ve bazı Imagen modellerinin gelişmiş özellikleri.

Hem Gemini Developer API hem de Vertex AI Gemini API kullanabilir miyim?

Evet, Firebase projenizde her iki "Gemini API" sağlayıcısını da etkinleştirebilir ve uygulamanızda her iki API'yi de kullanabilirsiniz.

Kodunuzda API sağlayıcılar arasında geçiş yapmak için arka uç hizmetini kodunuzda uygun şekilde ayarladığınızdan emin olmanız yeterlidir.

Önemli: Projeniz, Vertex AI Gemini API ve Firebase ile Google Cloud ekosistemindeki diğer bazı ürünlerin kullanımı için gerekli olan Blaze fiyatlandırma planı (kullandıkça öde) kapsamındaysa Gemini Developer API'a yapılan tüm çağrıların kullandıkça öde kapsamında olduğunu unutmayın.

Gerekli API'ler nelerdir? Bu özellikleri nasıl etkinleştirebilirim?

Sağlayıcıya özel içeriği görüntülemek için Gemini API sağlayıcınızı seçin Gemini Developer API Vertex AI Gemini API

Firebase AI Logic SDK'larını Gemini Developer API ile kullanmak için projenizde aşağıdaki iki API'nin etkinleştirilmiş olması gerekir:

• Gemini Developer API (generativelanguage.googleapis.com)
• Firebase AI Logic API (firebasevertexai.googleapis.com)

Bu iki API'yi Firebase konsolunu kullanarak etkinleştirmeniz gerekir:

1. Firebase konsolunda Firebase AI Logic sayfasına gidin.

2. Başlayın'ı tıklayın.

3. Gemini Developer API ile çalışmaya başlamak için seçin.

   Bu işlem, iki API'yi sizin için etkinleştiren rehberli bir iş akışı başlatır. Konsol ayrıca bir Gemini API anahtarı oluşturur ve Firebase AI Logic API'yi Firebase API anahtarınızın izin verilenler listesine ekler.

Hangi modeller Firebase AI Logic SDK'ları ile kullanılabilir?

Desteklenen modellerin listesini Desteklenen modeller hakkında bölümünde bulabilirsiniz. SDK'lara sık sık yeni özellikler ekliyoruz. Bu nedenle, güncellemeler için bu SSS'yi (sürüm notları, bloglar ve sosyal medya gönderileriyle birlikte) tekrar kontrol edin.

Gemini Developer API

Gemini ve Imagen temel modellerini kullanabilirsiniz.

Gemini Developer API (erişim şeklinden bağımsız olarak) yalnızca imagen-3.0-fast-generate-002 modeliyle görüntü oluşturmayı destekler.

Vertex AI Gemini API

Gemini ve Imagen temel modellerini kullanabilirsiniz.

Seçtiğiniz Gemini API sağlayıcıdan bağımsız olarak

Firebase AI Logic, aşağıdakileri desteklemez:

• Temel olmayan Gemini modeller (ör. PaLM modelleri, ayarlanmış modeller veya Gemma tabanlı modeller).

• Eski Imagen modelleri veya imagen-3.0-capability-001.

Modeller kullanımdan kaldırıldığında ne yapmalısınız?

Kararlı bir model sürümü yayınladığımızda, bu sürümün en az bir yıl boyunca kullanılabilmesini sağlamaya çalışırız. Bu "kullanımdan kaldırma tarihi"ni Firebase ve Google Cloud dokümanlarının çeşitli yerlerinde (ör. "Modeller" sayfasında) listeliyoruz.

Kullanımdan kaldırılan bir modele yapılan tüm istekler 404 hatasıyla başarısız olur. Bu nedenle, uygulamanızın yeni bir sürümünü yayınlamadan uygulamanızdaki modeli ve sürümü dinamik olarak değiştirebilmeniz için Firebase Remote Config'yı ayarlamanızı ve kullanmanızı önemle tavsiye ederiz.

Uygulamanızı yeni bir model sürümünü kullanacak şekilde güncellediğinizde, yanıtların beklendiği gibi olmaya devam ettiğinden emin olmak için uygulamanızı test etmenizi öneririz. Firebase AI Logic kullanılırken modeli gerçekten çağıran kodun herhangi birinde genellikle değişiklik yapılması gerekmediğini unutmayın.

Çeşitli modellerin kullanımdan kaldırılma tarihleri aşağıda verilmiştir:

• Gemini 1.5 Pro modelleri:

  • gemini-1.5-pro-002 (ve gemini-1.5-pro): 24 Eylül 2025
  • gemini-1.5-pro-001: 24 Mayıs 2025

• Gemini 1.5 Flash modelleri:

  • gemini-1.5-flash-002 (ve gemini-1.5-flash): 24 Eylül 2025
  • gemini-1.5-flash-001: 24 Mayıs 2025

• Gemini 1.0 Pro Vision modelleri: 21 Nisan 2025 (daha önce 9 Nisan 2025 olarak planlanmıştı)

• Gemini 1.0 Pro modelleri: 21 Nisan 2025 (daha önce 9 Nisan 2025 olarak planlanmıştı)

Kullanıcı başına hız sınırı nasıl belirleyebilirim?

Varsayılan olarak, Firebase AI Logic, kullanıcı başına istek sınırını dakikada 100 istek (RPM) olarak ayarlar.

Kullanıcı başına sıklık sınırınızı ayarlamak istiyorsanız Firebase AI Logic API'sinin kota ayarlarını düzenlemeniz gerekir.

Firebase AI Logic API kotası hakkında daha fazla bilgi edinin. Bu sayfada kotanızı nasıl görüntüleyip düzenleyeceğinizi de öğrenebilirsiniz.

Firebase AI Logic SDK'larını kullanmak için hangi izinler gerekir?

İşlem	Gerekli IAM izinleri	Gerekli izinleri varsayılan olarak içeren IAM rolleri
Faturalandırmayı kullandığınız kadar ödeyin (Blaze) fiyatlandırma planına yükseltme	firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment	Sahip
Projede API'leri etkinleştirme	serviceusage.services.enable	Düzenleyen Sahip
Firebase uygulaması oluşturma	firebase.clients.create	Firebase Yöneticisi Düzenleyici Sahip

Firebase AI Logic, modelleri eğitmek için verilerimi kullanır mı?

Veri yönetimi ve sorumlu yapay zeka başlıklı makaleyi inceleyin.

Çok formatlı isteklerimde MIME türü gerekli mi? (ör. resim, PDF, video ve ses girişi için)

Evet, her çok formatlı istekte her zaman aşağıdakileri sağlamanız gerekir:

• Dosyanın mimeType. Aşağıda bir istisna örneği verilmiştir.

• Dosya. Dosyayı satır içi veri olarak veya URL'sini kullanarak sağlayabilirsiniz.

Desteklenen giriş dosyası türleri, MIME türünün nasıl belirtileceği ve dosyanın Desteklenen giriş dosyaları ve koşullar bölümünde sağlanmasıyla ilgili iki seçenek hakkında bilgi edinin.

İsteğinize MIME türü eklemeyle ilgili istisna

MIME türü sağlama konusunda, yerel Android ve Apple platformu uygulamalarından gelen istekler için satır içi resim girişleri istisnadır.

Android ve Apple platformları için Firebase AI Logic SDK'ları, isteklerdeki resimleri işlemek için basitleştirilmiş ve platform dostu bir yöntem sunar. Tüm resimler (biçimlerinden bağımsız olarak) sunucuya gönderilmeden önce istemci tarafında% 80 kalitede JPEG'ye dönüştürülür. Bu, Android ve Apple platformlarının SDK'larını kullanarak resimleri satır içi veri olarak sağladığınızda istekte MIME türünü belirtmenize gerek olmadığı anlamına gelir.

Bu basitleştirilmiş işleme, Firebase AI Logic belgelerinde, isteklerde base64 kodlu resim gönderme örneklerinde gösterilmektedir.

Bu özellik hakkında platforma özel ek bilgileri aşağıda bulabilirsiniz:

• Android için:

  • Resimleri satır içi veri olarak içeren çok formatlı istemlerde platforma özgü resim türlerini (Bitmap) işlemeye yönelik basitleştirilmiş yöntemden yararlanabilirsiniz (örneğe bakın).

  • Resim biçimleri ve dönüşümleri üzerinde daha fazla kontrol sahibi olmak için resimleri InlineDataPart olarak sağlayabilir ve belirli MIME türünü belirtebilirsiniz. Örneğin:

    content { inlineData(/* PNG as byte array */, "image/png") }

• Apple platformları için:

  • Resimleri satır içi veri olarak içeren çok formatlı istemlerde platforma özgü resim türlerini (UIImage, NSImage, CIImage ve CGImage) işlemek için basitleştirilmiş yöntemden yararlanabilirsiniz (örneğe bakın).

  • Resim biçimleri ve dönüşümleri üzerinde daha fazla kontrol sahibi olmak için resimleri InlineDataPart olarak sağlayabilir ve belirli MIME türünü belirtebilirsiniz. Örneğin:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

Bu özellikler Firebase AI Logic kullanılırken kullanılabilir mi? Bağlam önbelleğe alma, araç olarak arama, Google Arama ile temellendirme, kod yürütme, modeli ince ayarlama, yerleştirme oluşturma ve semantik alma?

Bağlam önbelleğe alma, araç olarak arama, Google Arama ile temellendirme, kod yürütme, modeli ince ayarlama, yerleştirme oluşturma ve anlamsal alma Vertex AI Gemini API tarafından desteklenir ancak Firebase AI Logic kullanılırken kullanılamaz.

Bunları özellik isteği olarak eklemek veya mevcut bir özellik isteğine oy vermek istiyorsanız Firebase UserVoice'u ziyaret edin.

Gemini API anahtarı hakkında SSS

Bu SSS yalnızca Gemini Developer API kullanıyorsanız geçerlidir.

Gemini API anahtarı nedir?

Gemini Developer API, arayanı yetkilendirmek için "Gemini API anahtarı" kullanır. Bu nedenle, Gemini Developer API API'sini Firebase AI Logic SDK'ları üzerinden kullanıyorsanız bu API'ye çağrı yapmak için Firebase projenizde geçerli bir Gemini API anahtarına ihtiyacınız vardır.

"Gemini API anahtarı", API izin verilenler listesinde Gemini Developer API bulunan bir API anahtarı anlamına gelir.

Not: Gemini Developer API, Google Cloud konsolunda bazen "Generative Language API" olarak adlandırılır.

Firebase konsolunda Firebase AI Logic kurulum iş akışını tamamladığınızda yalnızca Gemini Developer API ile sınırlı bir Gemini API anahtarı oluştururuz ve bu API anahtarını kullanmak için Firebase AI Logic proxy hizmetini ayarlarız. Firebase tarafından oluşturulan bu Gemini API anahtarı, Google Cloud konsolunun kimlik bilgileri sayfasında Gemini Developer API key (auto created by Firebase) olarak adlandırılır.

API anahtarları için API kısıtlamaları hakkında daha fazla bilgi edinin.

Firebase AI Logic SDK'larını kullanırken Gemini API anahtarınızı uygulamanızın kod tabanına eklemezsiniz. Gemini API anahtarınızın güvenliğini sağlama hakkında daha fazla bilgi edinin.

Gemini API anahtarımı mobil veya web uygulamamın kod tabanına eklemeli miyim?

Firebase AI Logic SDK'larını kullanırken Gemini API anahtarınızı uygulamanızın kod tabanına eklemeyin.

Hatta Firebase AI Logic SDK'ları ile geliştirme yaparken Gemini API anahtarınızla doğrudan etkileşimde bulunmazsınız. Bunun yerine, Firebase AI Logic proxy hizmetimiz, Gemini Developer API'ye yapılan her isteğe Gemini API anahtarını dahili olarak ekler (tamamen arka uçta).

Uygulamanızı ciddi şekilde geliştirmeye başladığınız anda, yalnızca gerçek uygulamanızdan ve doğrulanmış cihazlardan gelen isteklerin arka uca iletilmesi için Firebase App Check ile entegrasyon yapmanız kritik önem taşır.

Gemini Developer API API'sini çağırmak için kullanılan Gemini API anahtarını nasıl değiştirebilirim?

Firebase AI Logic SDK'larını kullanırken Gemini API anahtarınızı değiştirmeniz gerekmez. Ancak, aşağıdaki iki durumda bunu yapmanız gerekebilir:

• Anahtarı yanlışlıkla sızdırdıysanız ve yeni bir güvenli anahtarla değiştirmek istiyorsanız.

• Anahtarı yanlışlıkla sildiyseniz Anahtarı silme işleminin ardından 30 gün içinde geri alabileceğinizi unutmayın.

Firebase AI Logic SDK'ları tarafından kullanılan Gemini API anahtarını nasıl değiştireceğinizi aşağıda bulabilirsiniz:

1. Firebase tarafından oluşturulan Gemini API anahtarınız hâlâ varsa bunu silin.

   Bu API anahtarını Google Cloud konsolunun API'ler ve Hizmetler > Kimlik Bilgileri panelinden silebilirsiniz. Bu anahtarın adı:
   Gemini Developer API anahtarı (Firebase tarafından otomatik olarak oluşturulur).

2. Aynı Google Cloud konsolu sayfasında yeni bir API anahtarı oluşturun. Bu anahtara
   Firebase için Gemini Geliştirici API anahtarı gibi bir ad vermenizi öneririz.

3. Bu yeni API anahtarına API kısıtlamaları ekleyin ve yalnızca Üretken Dil API'si'ni seçin.
   "Generative Language API", Gemini Developer API'nin Google Cloud konsolunda bazen kullanılan adıdır.

   Uygulama kısıtlamaları eklemeyin. Aksi takdirde, Firebase AI Logic proxy hizmeti beklendiği gibi çalışmaz.

4. Bu yeni anahtarı Gemini API anahtarı olarak ayarlamak için aşağıdaki komutu çalıştırın. Firebase AI Logic proxy hizmeti bu anahtarı kullanmalıdır.

   PROJECT_ID="PROJECT_ID"
   GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY"
   curl \
     -X PATCH \
     -H "x-goog-user-project: ${PROJECT_ID}" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \
     -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
   

   gcloud CLI hakkında bilgi edinin.

Bu yeni Gemini API anahtarını uygulamanızın kod tabanına eklememeye dikkat edin. Gemini API anahtarınızın güvenliğini sağlama hakkında daha fazla bilgi edinin.

Not: API anahtarlarıyla çalışırken sorularınız ve rehberlik için dilediğiniz zaman Firebase Destek Ekibi ile iletişime geçebilirsiniz.

"Firebase API anahtarımı" Gemini API anahtarı olarak kullanabilir miyim?

Hayır. "Firebase API anahtarınızı" Gemini API anahtarı olarak kullanmamalısınız. Firebase API anahtarınızın izin verilenler listesine eklememenizi önemle öneririz.Gemini Developer API

Firebase API anahtarınız, uygulamanızı Firebase'e bağlamak için uygulamanızın kod tabanına eklediğiniz Firebase yapılandırma dosyanızda veya nesnenizde listelenen API anahtarıdır. Anahtarı yalnızca Firebase ile ilgili API'lerle (ör. Firebase AI Logic) kullandığınızda Firebase API anahtarınızı kodunuza ekleyebilirsiniz. Firebase API anahtarları hakkında önemli bilgiler edinin.

Google Cloud konsolunun API'ler ve Hizmetler > Kimlik bilgileri panelinde Firebase API anahtarları şu şekilde görünür:

Firebase ile ilgili API'lerin çalışması için Firebase API anahtarınızı uygulamanızın kod tabanına eklemeniz gerektiğinden ve Gemini Developer API, API anahtarı aracılığıyla yetkilendirildiğinden Gemini Developer API'yı (Google Cloud konsolunda "Üretken Dil API'si" olarak adlandırılır) Firebase API anahtarınızın API izin verilenler listesine EKLEMEMENİZİ önemle tavsiye ederiz. Bu durumda Gemini Developer API, kötüye kullanıma açık hâle gelir.

Gemini API anahtarımın güvenliğini nasıl sağlarım?

Bu SSS'de, GeminiAPI anahtarınızın güvenliğini sağlamak için önerilen bazı en iyi uygulamalar açıklanmaktadır.

Gemini Developer API işlevini doğrudan mobil veya web uygulamanızdan çağırıyorsanız:

• Firebase AI Logic istemci SDK'larını kullanın.
• Gemini API anahtarınızı uygulamanızın kod tabanına eklemeyin.

Firebase AI Logic, Gemini Developer API'ye yapılan her isteğe dahili olarak Gemini API anahtarınızı ekleyen bir proxy hizmeti sağlar. Bu işlem tamamen arka uçta gerçekleşir.

Ayrıca, aşağıdakileri yapmanızı kesinlikle öneririz:

• Uygulamanızı ciddi şekilde geliştirmeye başladığınız anda, arka uç kaynaklarınızı ve üretken modelleri erişmek için kullanılan API'leri korumak üzere Firebase App Check ile entegrasyon yapın.

• Firebase tarafından oluşturulan Gemini API anahtarını Firebase AI Logic dışında yeniden kullanmayın. Başka bir kullanım alanı için Gemini API anahtarına ihtiyacınız varsa ayrı bir anahtar oluşturun.

• Genel olarak, Firebase tarafından oluşturulan Gemini API anahtarını DEĞİŞTİRMEMELİSİNİZ. Bu anahtar, Google Cloud konsolunda Gemini Developer API key (auto created by Firebase) olarak adlandırılır.

  • Firebase tarafından oluşturulan Gemini API anahtarınızın API izin verilenler listesine başka API eklemeyin. API izin verilenler listesinde, Gemini API anahtarınızda yalnızca Gemini Developer API (Google Cloud konsolunda "Üretken Dil API'si" olarak adlandırılır) olmalıdır.

  • Uygulama kısıtlamaları eklemeyin. Aksi takdirde, Firebase AI Logic proxy hizmeti beklendiği gibi çalışmaz.

Gemini API anahtarımın güvenliği ihlal edildi. Ne yapmanız gerekiyor?

Gemini API anahtarınızın güvenliği ihlal edildiyse Gemini Developer API'ı çağırmak için kullanılan Gemini API anahtarını değiştirme talimatlarını uygulayın.

Ayrıca, Gemini API anahtarınızı güvende tutmak için önerilen en iyi uygulamaları inceleyin.

Hataları giderme

Bu 404 hatasını nasıl düzeltebilirim? Firebase AI Logic genai config not found

Gemini Developer API kullanmaya çalışırken Firebase AI Logic genai config not found şeklinde bir 404 hatası alırsanız bu genellikle Firebase projenizde Gemini API anahtarının Firebase AI Logic istemci SDK'larıyla kullanılmak üzere geçerli olmadığı anlamına gelir.

Bu hatanın en olası nedenleri şunlardır:

• Firebase projenizi henüz Gemini Developer API için ayarlamadınız.

  Yapılacak işlem:
  Firebase konsolunda Firebase AI Logic sayfasına gidin. Başlayın'ı tıklayın ve Gemini Developer API'ı seçin. API'yi etkinleştirin. Konsol, projenizi Gemini Developer API için ayarlar. İş akışını tamamladıktan sonra isteğinizi tekrar deneyin.

• Firebase AI Logic kurulum iş akışınıFirebase konsolunda çok kısa süre önce tamamladıysanız Gemini API anahtarınız henüz tüm bölgelerdeki gerekli arka uç hizmetlerinde kullanılamıyor olabilir.

  Ne yapmalısınız?
  Birkaç dakika bekleyip isteğinizi tekrar deneyin.

• Gemini API anahtarınız, Firebase projenizden silinmiş olabilir.

  Ne yapmalısınız?
  Firebase AI Logic tarafından kullanılan Gemini API anahtarını nasıl değiştireceğinizi öğrenin.

Bu 400 hatasını nasıl düzeltebilirim? Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Cloud Storage for Firebase URL içeren çok formatlı bir istek göndermeye çalışıyorsanız aşağıdaki 400 hatasıyla karşılaşabilirsiniz:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Bu hata, Vertex AI API'si projede etkinleştirildiğinde gerekli hizmet aracıları otomatik olarak doğru şekilde sağlanmadığı için oluşur. Bu, bazı projelerde bilinen bir sorundur ve küresel bir düzeltme üzerinde çalışıyoruz.

Projenizi düzeltmek ve bu hizmet aracılarının doğru şekilde sağlanmasını sağlamak için geçici çözümü aşağıda bulabilirsiniz. Böylece, çok formatlı isteklerinize Cloud Storage for Firebase URL'lerini eklemeye başlayabilirsiniz. Projede Sahip rolüne sahip olmanız gerekir ve bu görevleri projeniz için yalnızca bir kez tamamlamanız yeterlidir.

1. gcloud CLI ile erişin ve kimliğinizi doğrulayın.
   Bu işlemi yapmanın en kolay yolu Cloud Shell'dır. Daha fazla bilgi için Google Cloud dokümanlarına göz atın.

2. İstenirse gcloud CLI komutunun Firebase projenize karşı çalıştırılması için terminalde gösterilen talimatları uygulayın.

   Project settings bölümünün üst kısmında bulabileceğiniz Firebase proje kimliğiniz gereklidir.Firebase

3. Aşağıdaki komutu çalıştırarak projenizde gerekli hizmet aracılarının sağlanmasını gerçekleştirin:

   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. Hizmet aracılarının sağlandığından emin olmak için birkaç dakika bekleyin ve ardından Cloud Storage for Firebase URL'sini içeren çok formatlı isteğinizi tekrar göndermeyi deneyin.

Birkaç dakika bekledikten sonra bu hatayı almaya devam ederseniz Firebase Destek Ekibi ile iletişime geçin.

Bu 400 hatasını nasıl düzeltebilirim? API key not valid. Please pass a valid API key.

API key not valid. Please pass a valid API key. şeklinde bir 400 hatası alırsanız bu genellikle Firebase yapılandırma dosyanızdaki/nesnenizdeki API anahtarının mevcut olmadığı veya uygulamanız ve/veya Firebase projenizle kullanılacak şekilde ayarlanmadığı anlamına gelir.

Firebase yapılandırma dosyanızda/nesnenizde listelenen API anahtarının uygulamanızın API anahtarıyla eşleştiğini kontrol edin. Tüm API anahtarlarınızı Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik Bilgileri panelinde görüntüleyebilirsiniz.

Eşleşmediklerini fark ederseniz yeni bir Firebase yapılandırma dosyası/nesnesi edinin ve uygulamanızdaki dosyayı/nesneyi değiştirin. Yeni yapılandırma dosyası/nesnesi, uygulamanız ve Firebase projeniz için geçerli bir API anahtarı içermelidir.

Bu 403 hatasını nasıl düzeltebilirim? Requests to this API firebasevertexai.googleapis.com ... are blocked.

Requests to this API firebasevertexai.googleapis.com ... are blocked. şeklinde bir 403 hatası alırsanız bu genellikle Firebase yapılandırma dosyanızdaki/nesnenizdeki API anahtarının, kullanmaya çalıştığınız ürün için izin verilenler listesinde gerekli bir API'ye sahip olmadığı anlamına gelir.

Uygulamanızın kullandığı API anahtarının, anahtarın "API kısıtlamaları " izin verilenler listesinde gerekli tüm API'leri içerdiğinden emin olun. Firebase AI Logic için API anahtarınızın izin verilenler listesinde en azından Firebase AI Logic API'si bulunmalıdır.

Tüm API anahtarlarınızı Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik Bilgileri panelinde görüntüleyebilirsiniz.

Not: Firebase ile ilgili API'ler, API anahtarlarını yalnızca Firebase projesini veya uygulamasını tanımlamak için kullanır. API'yi çağırmak için yetkilendirme (bazı diğer API'lerin izin verdiği gibi) için kullanmaz. Firebase ile ilgili API'ler için yetkilendirme, API anahtarından ayrı olarak Google Cloud IAM izinleriFirebase Security Rules veya Firebase App Check aracılığıyla yapılır. Firebase API anahtarları hakkında daha fazla bilgi edinin.

Bu 403 hatasını nasıl düzeltebilirim? PERMISSION_DENIED: The caller does not have permission.

PERMISSION_DENIED: The caller does not have permission. şeklinde bir 403 hatası alırsanız bu genellikle Firebase yapılandırma dosyanızdaki/nesnenizdeki API anahtarının farklı bir Firebase projesine ait olduğu anlamına gelir.

Firebase yapılandırma dosyanızda/nesnenizde listelenen API anahtarının uygulamanızın API anahtarıyla eşleştiğini kontrol edin. Tüm API anahtarlarınızı Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik Bilgileri panelinde görüntüleyebilirsiniz.

Eşleşmediklerini fark ederseniz yeni bir Firebase yapılandırma dosyası/nesnesi edinin ve uygulamanızdaki dosyayı/nesneyi değiştirin. Yeni yapılandırma dosyası/nesnesi, uygulamanız ve Firebase projeniz için geçerli bir API anahtarı içermelidir.

Firebase AI Logic ile ilgili deneyiminiz hakkında geri bildirim verme