SSS ve sorun giderme

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 için taşıma kılavuzunu inceleyin (ve isterseniz Gemini Developer API'ı kullanmaya başlayın).

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

Aşağıdaki tabloda, iki "Gemini API" sağlayıcı arasındaki önemli farklar genel olarak, bunlara nasıl eriştiğinizden bağımsız olarak listelenmiştir:

¹ İki API sağlayıcının kullandıkça öde fiyatlandırması farklıdır (ilgili belgelerden daha fazla bilgi edinebilirsiniz).

² 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.

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.

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

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.

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, Firebase konsolundaki rehberli iş akışı gibi belirli yolculuklar sırasında 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.

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

Desteklenen modellerin listelerine bakın. 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, ince ayarlı modeller veya Gemma tabanlı modeller).

    • Eski Imagen modelleri 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ı belgelerinde ve Firebase belgelerinde (desteklenen modeller sayfasına bakın) birkaç yerde listeleriz.

• Kapatma 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 kapatmalarla ilgili hatırlatıcılar yayınlarız (ör. Gemini 1.5 ve 1.0 kararlı modelleri için kapatma tarihleri hatırlatıcısı).

Kullandığınız model kapatılmak üzereyse ne yapmalısınız?

1. Uygun bir şu anda desteklenen model ve model adını bulun.

2. 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, LiveModel veya ImagenModel örneği oluşturduğunuzda 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.

3. Yanıtların beklendiği gibi olduğundan emin olmak için uygulamanızı test edin.

Imagen Kararlı modeller - Kapanma 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 - Kapanma 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 gemini-2.0-flash takma adı)
  gemini-2.0-flash-lite-001 (ve otomatik olarak güncellenen gemini-2.0-flash-lite takma adı)

  • 6 Şubat 2026: Bu modeller, daha önce modelin kullanılmadığı 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-preview) deneyin.

Gemini 1.5 ve 1.0 kararlı modelleri - kapatılma tarihleri ve alternatifleri

• 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ı)

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-preview) deneyin.

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ın kullanılabilmesi için hangi izinler gerekebilir?

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 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 isteğe 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:

  • Görüntüleri satır içi veri olarak içeren çok formatlı istemlerde platforma özgü görüntü türlerini (Bitmap) 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:

    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, modeli ince ayarlama, yerleştirme oluşturma ve semantik alma?

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:

• Bağlamı önbelleğe alma
• Modelde ince ayar yapma
• Yerleştirilmiş öğe oluşturma
• Anlamsal alma

Bu özellikleri özellik isteği olarak eklemek veya mevcut bir özellik isteğine oy vermek isterseniz Firebase UserVoice'u ziyaret edin.

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şlevleri 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 adı FirebaseAILogic olarak değiştirmemiz 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, eski sürümlerle uyumluluğu bozmaz. Ancak sonunda, gelecekteki bir Firebase SDK'sında geriye dönük uyumsuzluk yaratan büyük bir sürümle 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:

1. Swift PM bağımlılarını seçerken FirebaseAILogic'yı (FirebaseAI yerine) seçin.

2. İçe aktarma ifadelerini FirebaseAILogic (FirebaseAI yerine) olarak değiştirin.

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ına ihtiyacınız vardı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 gerekmez. 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 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 panelinde 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 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.

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.

"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 "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 ç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. 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.