Bu sayfada, Firebase AI Logic SDK'ları ve Gemini API hakkında sık sorulan soruların (SSS) yanıtları ve sorun giderme bilgileri yer almaktadır.
Gerekirse aşağıdaki ek kaynaklardan yararlanabilirsiniz:
Hata kodlarıyla ilgili sorunları giderme
Faturalandırma ayarları, fiyatlandırma ve ödemeler hakkında bilgi edinin.
Hız sınırları ve kotalar hakkında bilgi edinin.
Durum kontrol panelleri
Vertex AI Gemini API (
Vertex Gemini APIveVertex Imagen API)
Genel SSS
Gemini Developer API ile Vertex AI Gemini API arasındaki farklar nelerdir?
Aşağıdaki tabloda, iki "Gemini API" sağlayıcı arasındaki önemli farklar genel olarak, erişim şeklinizden bağımsız olarak listelenmiştir:
| Gemini Developer API | Vertex AI Gemini API | |
|---|---|---|
| Fiyatlandırma | Hem ücretsiz Spark fiyatlandırma planında hem de kullandıkça öde Blaze fiyatlandırma planında kullanılabilir1. | Her zaman kullandıkça ödeyin Blaze fiyatlandırma planı1 gerekir (Firebase AI Logic ile kullanıldığında). |
| Hız sınırları (kota) | Açık hız sınırları | Aynı bölgede bu modeli kullanan herkesin paylaştığı dinamik paylaşılan kota (DSQ) kullanılır. Temel hazırlığı yapılmış işleme hızı (PT) kullanılabilir. |
| Modele erişmek için konumu belirtme | API tarafından desteklenmiyor | API tarafından desteklenir |
| Cloud Storage URL'leri için destek | API tarafından desteklenmiyor 2 |
Herkese açık dosyalar ve Firebase Security Rules tarafından 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 |
1 İki API sağlayıcının kullandıkça öde fiyatlandırması farklıdır (ilgili belgelerden daha fazla bilgi edinebilirsiniz).
2 Gemini Developer API için Files API, Firebase AI Logic SDK'ları üzerinden desteklenmez.
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 | destekleniyor | destekleniyor |
| Gemini Live API için destek | destekleniyor | destekleniyor |
| Firebase App Check ile entegrasyon | destekleniyor | destekleniyor |
| Firebase Remote Config ile uyumlu | destekleniyor | destekleniyor |
| Firebase konsolunda yapay zeka izleme desteği | destekleniyor | destekleniyor |
Hem Gemini Developer API hem de Vertex AI Gemini API kullanabilir miyim?
Evet, Firebase projenizde hem "Gemini API" sağlayıcılarını etkinleştirebilir hem de 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.
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 |
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:
Firebase konsolunda AI Services > AI Logic'e gidin.
Başlayın'ı tıklayın.
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.
Firebase projemdeki API'leri nasıl devre dışı bırakabilirim?
Firebase AI Logic için, seçtiğiniz Gemini API sağlayıcısını kullanmak üzere Firebase projenizin kurulumunu olabildiğince kolaylaştırmaya çalışıyoruz. Bu, belirli yolculuklar sırasında (ör. Firebase konsolundaki rehberli iş akışı) Firebase projenizde gerekli API'lerin etkinleştirilmesini içerir.
Ancak Firebase AI Logic veya Gemini API sağlayıcılarından birini kullanmamaya karar verirseniz Firebase projenizde ilişkili API'leri devre dışı bırakabilirsiniz.
Gemini Developer API kullanımıyla ilişkili API'leri devre dışı bırakma
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)
Firebase AI Logic'ı tamamen kullanmayı bırakmak istiyorsanız:
Google Cloud konsolunda ilgili API sayfalarına gitmek için yukarıdaki her bir API bağlantısını tıklayın, ardından Yönet'i tıklayın.
API'nin kullanılmadığını doğrulamak için Metrikler sekmesini görüntüleyin.
API'yi yine de devre dışı bırakmak istiyorsanız sayfanın üst kısmındaki API'yi devre dışı bırak'ı tıklayın.
Firebase AI Logic API'yi, Firebase API anahtarlarınız kullanılarak çağrılabilen seçili API'ler listesinden kaldırın. Bu listeyi değiştirme hakkında bilgi edinmek için Firebase API anahtarları için izin verilenler listesiyle ilgili bu SSS'yi inceleyin.
Firebase AI Logic'i kullanmaya devam etmek istiyorsanız ancak Vertex AI Gemini API ile kullanmak istiyorsanız:
Google Cloud konsolunda Gemini Developer API sayfasına gidin ve Yönet'i tıklayın.
API'nin kullanılmadığını doğrulamak için Metrikler sekmesini görüntüleyin.
API'yi yine de devre dışı bırakmak istiyorsanız sayfanın üst kısmındaki API'yi devre dışı bırak'ı tıklayın.
Projenizde Vertex AI Gemini API için gerekli API'lerin etkinleştirildiğinden emin olun.
Vertex AI Gemini API kullanımıyla ilişkili API'leri devre dışı bırakma
Firebase AI Logic SDK'larını Vertex AI Gemini API ile kullanmak için projenizde aşağıdaki iki API'nin etkinleştirilmiş olması gerekir:
- Vertex AI API (
aiplatform.googleapis.com) - Firebase AI Logic API (
firebasevertexai.googleapis.com)
Firebase AI Logic'ı tamamen kullanmayı bırakmak istiyorsanız:
Google Cloud konsolunda ilgili API sayfalarına gitmek için yukarıdaki her bir API bağlantısını tıklayın, ardından Yönet'i tıklayın.
API'nin kullanılmadığını doğrulamak için Metrikler sekmesini görüntüleyin.
API'yi yine de devre dışı bırakmak istiyorsanız sayfanın üst kısmındaki API'yi devre dışı bırak'ı tıklayın.
Firebase AI Logic API'yi, Firebase API anahtarlarınız kullanılarak çağrılabilen seçili API'ler listesinden kaldırın. Bu listeyi değiştirme hakkında bilgi edinmek için Firebase API anahtarları için izin verilenler listesiyle ilgili bu SSS'yi inceleyin.
Firebase AI Logic'i kullanmaya devam etmek istiyorsanız ancak Gemini Developer API ile kullanmak istiyorsanız:
Google Cloud konsolunda Vertex AI API sayfasına gidin ve Yönet'i tıklayın.
API'nin kullanılmadığını doğrulamak için Metrikler sekmesini görüntüleyin.
API'yi yine de devre dışı bırakmak istiyorsanız sayfanın üst kısmındaki API'yi devre dışı bırak'ı tıklayın.
Projenizde Gemini Developer API için gerekli API'lerin etkinleştirildiğinden emin olun.
Hangi modeller Firebase AI Logic SDK'ları ile kullanılabilir?
Desteklenen modellerin listelerini inceleyin. 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
Hem Gemini hem de Imagen temel modelleri.
Gemini Developer API'nın (erişim şeklinden bağımsız olarak) yalnızca belirli kararlı Imagen modelleri desteklediğini unutmayın.
Vertex AI Gemini API
- Hem Gemini hem de Imagen temel modelleri.
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 modeller veya
imagen-3.0-capability-001.
Modeller kapatıldığında (kullanımdan kaldırıldığında) ne yapmalısınız?
Kararlı bir model sürümü yayınladığımızda, modeli kullanımdan kaldırmadan önce en az bir yıl boyunca kullanılabilir olmasını sağlamaya çalışırız.
Bir modelin kapatılma tarihini nerede bulabilirim?
Bir modelin kapatılma tarihini bulabileceğiniz bazı yöntemler şunlardır:
Yayın tarihinde: Her modelin beklenen kapatılma tarihini Gemini API sağlayıcı dokümanlarının yanı sıra Firebase dokümanlarında (desteklenen modeller sayfasını inceleyin) birkaç yerde listeleriz.
Kullanımdan kaldırma tarihi yaklaştıkça: Google, ilgili proje üyelerine e-posta gönderir. Ayrıca, yayın notlarında ve diğer kanallarda yaklaşan kullanımdan kaldırma işlemleriyle ilgili hatırlatıcılar yayınlarız (ör. Gemini 1.5 ve 1.0 kararlı modelleri için kullanımdan kaldırma tarihlerini hatırlatma).
Kullandığınız model kapatılmak üzereyse ne yapmalısınız?
Uygun bir şu anda desteklenen model ve model adını bulun.
Uygulamanızın kullandığı model adını kapatma tarihinden önce güncelleyin. Aksi takdirde, bu modele yapılan tüm istekler 404 hatasıyla başarısız olur.
Model adını,
GenerativeModel,LiveModelveyaImagenModelörneği oluştururken başlatma sırasında ayarlarsınız. Aşağıda Firebase Remote Config kullanımıyla ilgili önemli öneriyi incelemeyi unutmayın.Firebase AI Logic kullanırken modeli gerçekten çağıran kodun herhangi bir bölümünü genellikle değiştirmeniz gerekmez.
Yanıtların beklendiği gibi olduğundan emin olmak için uygulamanızı test edin.
Imagen kararlı modeller - kapatma tarihleri ve değişimler
- Tüm Imagen modelleri 24 Haziran 2026'da kapatılacak.
Değiştirme: Uygulamalarınızı Gemini görüntü modellerini ("Nano Banana" modelleri) kullanacak şekilde taşıyın.
Gemini 2.0 kararlı modeller - kapatma tarihleri ve değişimler
Gemini 2.0 Flash ve Gemini 2.0 Flash‑Lite:
gemini-2.0-flash-001(ve otomatik olarak güncellenen diğer adıgemini-2.0-flash)
gemini-2.0-flash-lite-001(ve otomatik olarak güncellenen diğer adıgemini-2.0-flash-lite)6 Şubat 2026: Bu modeller, daha önce kullanılmadıkları projelerde artık kullanılamayacak.
31 Mart 2026: Bu modeller kapatılacak.
Kararlı Gemini Live API 2.0 modellerinin bu durumdan etkilenmediğini unutmayın.
Değiştirme: Gemini 2.5 modelini (ör. gemini-2.5-flash-lite) kullanmaya geçin veya yeni Gemini 3 modellerinden birini (ör. gemini-3.1-flash-lite) deneyin.
Gemini 1.5 ve 1.0 kararlı modelleri - kapatılma tarihleri ve alternatifleri
Gemini 1.5 Pro modelleri:
gemini-1.5-pro-002(vegemini-1.5-pro): 24 Eylül 2025gemini-1.5-pro-001: 24 Mayıs 2025
Gemini 1.5 Flash modelleri:
gemini-1.5-flash-002(vegemini-1.5-flash): 24 Eylül 2025gemini-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ı)
Değiştirme: Gemini 2.5 modelini (ör. gemini-2.5-flash-lite) kullanmaya geçin veya yeni Gemini 3 modellerinden birini (ör. gemini-3.1-flash-lite) deneyin.
Firebase AI Logic SDK'larını kullanmak için hangi izinler gerekebilir?
| İşlem | Gerekli IAM izinleri | Gerekli izinleri varsayılan olarak içeren IAM rolleri |
|---|---|---|
| Faturalandırmayı kullandıkça öde (Blaze) fiyatlandırma planına yükseltme | firebase.billingPlans.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
|
Sahip |
| Projede API'leri etkinleştirme | serviceusage.services.enable |
Düzenleyici 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.
Kullanıcı başına hız sınırını nasıl ayarlayabilirim?
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üleyeceğinizi ve düzenleyeceğinizi de öğrenebilirsiniz.
Gecikmeyi ve yüksek jeton kullanımını nasıl azaltabilirim?
Yüksek gecikme veya yüksek jeton kullanımı yaşıyorsanız bunun nedeni, kullandığınız modelin düşünme düzeyi yapılandırması olabilir.
Gemini 3 ve sonraki modeller, muhakeme ve çok adımlı planlama yeteneklerini önemli ölçüde geliştiren dahili bir "düşünme süreci" kullanır. Bu sayede kodlama, ileri matematik ve veri analizi gibi karmaşık görevlerde oldukça etkili olurlar.
Ancak göreve bağlı olarak her zaman daha yüksek düşünme düzeyleri gerekmez ve modeli daha düşük bir düşünme düzeyini kullanacak şekilde yapılandırabilirsiniz. Daha düşük bir düşünce seviyesi, gecikmeyi ve jeton kullanımını azaltmaya yardımcı olur. Bir modelin düşünme yeteneğine ne kadar ihtiyaç duyabileceğine karar vermenize yardımcı olması için görev zorluklarının karşılaştırmasını inceleyin.
Çoğu Gemini 3 ve sonraki modellerde varsayılan düşünme seviyesinin HIGH olarak ayarlandığını unutmayın.
Ç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 sağlanmasıyla ilgili iki seçenek hakkında bilgi edinmek için Desteklenen giriş dosyaları ve şartlar başlıklı makaleyi inceleyin.
İ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ı 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 belgelerindeki isteklerde base64 kodlu resim gönderme örneklerinde gösterilmektedir.
Bu özellik hakkında platforma özel ek bilgileri aşağıda bulabilirsiniz:
Android için:
Görüntüleri satır içi veri olarak içeren çok formatlı istemlerde platforma özgü görüntü türlerini (
Bitmap) işleme yöntemini basitleştiren bu özellikten yararlanabilirsiniz (örneğe bakın).Resim biçimleri ve dönüşümleri üzerinde daha fazla kontrol sahibi olmak için resimleri
InlineDataPartolarak 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,CIImageveCGImage) 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
InlineDataPartolarak sağlayabilir ve belirli MIME türünü belirtebilirsiniz. Örneğin:InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")
Firebase AI Logic: Google Görsel Arama ile temellendirme, modele ince ayar yapma, yerleştirme oluşturma ve semantik alma özellikleri kullanılabilir mi?
Aşağıdaki özellikler çeşitli modeller ve API sağlayıcılar tarafından desteklenir ancak Firebase AI Logic kullanılırken kullanılamaz:
- Google Görsel Arama ile Temellendirme
- Model ince ayarı
- Yerleştirilmiş öğe oluşturma
- Anlamsal alma
Bunları özellik isteği olarak eklemek veya mevcut bir özellik isteğine oy vermek isterseniz Firebase UserVoice'u ziyaret edin.
Ad neden "Vertex AI in Firebase"dan "Firebase AI Logic"a değiştirildi?
2024'te, Vertex AI Gemini API kullanabilen bir dizi Firebase istemci SDK'sı ve bu API'yi kötüye kullanımdan 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 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 entegrasyonumuzu kullanarak Gemini Developer API'yı kötüye kullanıma karşı koruma özelliği de bu desteğe dahildir.
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, Firebase AI Logic adlı yeni ad, 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 isteğe bağlı olarak Gemini Developer API'ı kullanmaya başlamak) için taşıma kılavuzuna göz atın.
Apple platformlarındaki Swift uygulamaları için: FirebaseAI olan modül adının FirebaseAILogic olarak değiştirilmesiyle ilgili ne yapmalıyım?
Apple platformu uygulamalarında, Firebase SDK'sının 12.5.0 sürümünden itibaren,
Firebase AI Logic artık FirebaseAILogic modülü altında dağıtılmaktadır.
Bu değişikliği, mevcut işleyişi bozmayacak ve eski sürümlerle uyumlu olacak şekilde yaptık.
Bu değişikliği neden yaptık?
Bu hizmeti daha önce FirebaseAI modülü altında dağıtıyorduk. Ancak aşağıdaki nedenlerden dolayı bu öğeyi FirebaseAILogic olarak yeniden adlandırmamız gerekti:
İkili dağıtımlarda sorunlara neden olan modül ve sınıf arasında ad çakışmasını önleyin.
Gelecekteki özellik geliştirmelerinde Swift makrolarını kullanmamızı sağlar.
v12.5.0 veya sonraki bir sürüme yükseltme yapıyorsanız ne yapmalısınız?
Modül adının FirebaseAILogic olarak değiştirilmesi, mevcut işlevleri etkilemez ve geriye dönük olarak uyumludur. Ancak sonunda, gelecekteki büyük bir Firebase SDK'sında geriye dönük uyumsuzluk yaratan değişiklik sürümüyle birlikte eski modülü kaldırabiliriz (zaman aralığı şu anda belirlenmemiştir).
Bu modül adı değişikliği için gerekli bir değişiklik yoktur ancak aşağıdakileri yapmanızı öneririz:
Swift PM bağımlılarını seçerken
FirebaseAILogic'yı (FirebaseAIyerine) seçin.İçe aktarma ifadelerini
FirebaseAILogic(FirebaseAIyerine) olarak değiştirin.
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'yi çağırmak için Firebase projenizde geçerli bir Gemini API anahtarı olmalıdır.
"Gemini API anahtarı", API izin verilenler listesinde Gemini Developer API bulunan bir API anahtarı anlamına gelir.
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 anahtarı (Firebase tarafından otomatik olarak oluşturuldu) 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 hizmetine yapılan her isteğe Gemini API anahtarını dahili olarak ekler. Bu işlem tamamen arka uçta gerçekleşir.
Gemini API anahtarını kullanarak Gemini Developer API'ı nasıl çağırabilirim?
Firebase AI Logic SDK'larını kullanırken Gemini API anahtarınızı değiştirmeniz pek olası değildir. Ancak şu 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 Silme işleminden sonraki 30 gün içinde anahtarı geri yükleyebileceğ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:
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 panelinde silebilirsiniz. Bu anahtarın adı:
Gemini Developer API key (auto created by Firebase).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.Bu yeni API anahtarına API kısıtlamaları ekleyin ve yalnızca Generative Language API'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.
Bu yeni anahtarı, Firebase AI Logic proxy hizmetinin kullanması gereken Gemini API anahtarı olarak ayarlamak için aşağıdaki komutu çalıştırın.
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.
"Firebase API anahtarımı" Gemini API anahtarı olarak kullanabilir miyim?
Hayır. "Firebase API anahtarınızı" API anahtarınız olarak kullanmamalısınız.Gemini 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 "Generative Language API" 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, Gemini API anahtarınızı güvende tutmak için önerilen bazı en iyi uygulamalar açıklanmaktadır.
Gemini Developer API'ı doğrudan mobil veya web uygulamanızdan arı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 istekte Gemini API anahtarınızı dahili olarak içeren 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, Firebase App Check ile entegrasyon yaparak arka uç kaynaklarınızı ve üretken modellerin erişiminde kullanılan API'leri koruyabilirsiniz.
Firebase tarafından oluşturulan Gemini API anahtarını Firebase AI Logic dışında yeniden kullanmayın. Gemini API anahtarını başka bir kullanım alanı için kullanmanız gerekiyorsa 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'ler eklemeyin. API izin verilenler listesinde, Gemini API anahtarınızda yalnızca Gemini Developer API (Google Cloud konsolunda "Generative Language API" 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.
Firebase AI Logic ile ilgili deneyiminiz hakkında geri bildirim verme