Hata kodları

400 hatası: 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.

400 hatası: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Cloud Storage for Firebase URL'si 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, Agent Platform API projede etkinleştirildiğinde gerekli hizmet aracılarının projede otomatik olarak doğru şekilde sağlanmamasından kaynaklanır. Bu, bazı projelerde bilinen bir sorundur ve küresel bir düzeltme üzerinde çalışıyoruz.

Projenizi düzeltmek ve bu hizmet aracılarını doğru şekilde 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. Projenin sahibi olmanız ve bu görevleri projeniz için yalnızca bir kez tamamlamanız gerekir.

1. gcloud CLI ile erişin ve kimliğinizi doğrulayın.
   Bu işlemi yapmanın en kolay yolu Cloud Shell üzerinden gerçekleştirmektir. Daha fazla bilgiyi Google Cloud belgelerinde bulabilirsiniz.

2. İstenirse terminalde gösterilen talimatları uygulayarak gcloud CLI komutunu Firebase projenize karşı çalıştırın.

   Firebase proje kimliğinizi bilmeniz gerekir. Bu kimliği settings Proje ayarları Firebasebölümünün üst kısmında bulabilirsiniz.

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

   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.

403 hatası: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

403 - PERMISSION_DENIED hatası alırsanız To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, isteğinizde geçerli bir App Check jetonu yok demektir ve genellikle kötüye kullanılan bir modele erişmeye çalışıyorsunuzdur.

Bazı üretken modellerin, kötü niyetli kullanıcılar tarafından yaygın olarak kötüye kullanıldığı tespit edildi.

Firebase AI Logic için App Check zorunlu kılınmadığından projeniz bu modellerin kötüye kullanımına karşı savunmasızdır. Firebase, geliştiricilerimizin korunmasına yardımcı olmak için istek geçerli bir App Check jetonu içermediği sürece bu modellere erişimi engeller (yani App Check, Firebase AI Logic için zorunlu kılınır).

Hatayı döndüren modele erişmek istiyorsanız aşağıdakileri yapın:

1. Firebase AI Logic için App Check'i kurun. Yerel geliştirme için App Check hata ayıklama sağlayıcısını ayarladığınızdan emin olun.

   App Check politikasına uyulmasını sağlamak, Gemini API ve Gemini modellerini kötüye kullanıma karşı korumak için çok önemlidir. Bu hatayı düzeltmek için bu politikanın uygulanması gerekir.

2. Uygulamanızdan Firebase AI Logic'e isteği yeniden gönderin.

   Bu istek, geçerli bir App Check jetonuyla birlikte gönderilir ve artık bu 403 - PERMISSION_DENIED hatasını almazsınız.

3. Uygulamanızı son kullanıcılara yayınlamadan önce, son kullanıcılarınız App Check zorunlu kılındığında yapay zeka özelliğinize erişebilmesi için bir üretim onayı sağlayıcısı ayarlamanız (ör. App Attest, Play Integrity veya reCAPTCHA Enterprise) gerekir.

403 hatası: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

403 - PERMISSION_DENIED hatası alırsanız Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, Firebase projenizin etkin olmadığı ve App Check için Firebase AI Logic zorunlu kılınmadığı anlamına gelir.

"Etkin olmayan projeler", Firebase AI Logic özelliği etkinleştirilmiş ancak Firebase AI Logic özelliği son zamanlarda kullanılmamış olan projelerdir.

Firebase AI Logic için App Check zorunlu kılmadığınızdan projeniz Gemini API kötüye kullanımına karşı savunmasızdır. Firebase, projeniz i korumak için Firebase AI Logic üzerinde App Check zorunlu kılınana kadar Firebase AI Logic kullanımını devre dışı bıraktı.

Firebase AI Logic özelliğini tekrar kullanmaya hazır olduğunuzda aşağıdakileri yapın:

1. Firebase AI Logic için App Check'i kurun. Yerel geliştirme için App Check hata ayıklama sağlayıcısını ayarladığınızdan emin olun.

   App Check politikasına uyulmasını sağlamak, Gemini API ve Gemini modellerini kötüye kullanıma karşı korumak için çok önemlidir. Bu hatayı düzeltmek için bu politikanın uygulanması gerekir.

2. Uygulamanızdan Firebase AI Logic'e isteği yeniden gönderin.

   Bu istek, geçerli bir App Check jetonuyla birlikte gönderilir ve artık bu 403 - PERMISSION_DENIED hatasını almazsınız.

3. App Check'u zaten zorunlu kılıyorsanız ve bu hatayı almaya devam ediyorsanız Firebase AI Logic için yeniden oynatma korumasının etkin olup olmadığını kontrol edin (yalnızca izleme modu da dahil).

   Yeniden oynatma koruması etkin olduğunda, Firebase AI Logic için yalnızca sınırlı kullanımlı jetonlar doğrulanmış olarak kabul edilir. Normal oturum jetonları bu hatayı temizlemez. Ya uygulamanızda sınırlı kullanım jetonlarını etkinleştirin ya da Firebase AI Logic için yeniden oynatma korumasını devre dışı bırakın, isteği yeniden gönderin ve yeniden oynatma korumasını tekrar etkinleştirmeden önce yaklaşık bir gün bekleyin (proje etkinliği günlük olarak yeniden değerlendirilir).

4. Uygulamanızı son kullanıcılara yayınlamadan önce, son kullanıcılarınız App Check zorunlu kılındığında yapay zeka özelliğinize erişebilmesi için bir üretim onayı sağlayıcısı ayarlamanız (ör. App Attest, Play Integrity veya reCAPTCHA Enterprise) gerekir.

403 hatası: 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.

403 hatası: 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 durum genellikle uygulamanızdaki Firebase yapılandırmanızda bulunan API anahtarının, gerekli API'yi çağırmasını engelleyen kısıtlamalara sahip olduğu anlamına gelir.

Bu sorunu düzeltmek için Google Cloud konsolunda API anahtarınızın kısıtlamalarını gerekli API'yi içerecek şekilde güncellemeniz gerekir. Firebase AI Logic için Firebase AI Logic API'nin (firebasevertexai.googleapis.com) API anahtarı kullanılarak çağrılabilen seçili API'ler listesinde yer aldığından emin olmanız gerekir.

Aşağıdaki adımları uygulayın:

1. Google Cloud konsolunda API'ler ve Hizmetler > Kimlik Bilgileri panelini açın.

2. Uygulamanızın kullanmak üzere yapılandırıldığı API anahtarını seçin (örneğin, iOS uygulaması için "iOS anahtarı").

3. API anahtarını düzenle sayfasında API kısıtlamaları bölümünü bulun.

4. Anahtarı kısıtla seçeneğinin belirlendiğinden emin olun. Aksi takdirde anahtarınız sınırsızdır ve hatanın kaynağı muhtemelen bu değildir.

   "API kısıtlamaları" uygulamanızı önemle tavsiye ederiz.

5. Selected APIs (Seçilen API'ler) açılır menüsünde, API anahtarıyla çağrılabilen seçili API'ler listesine eklemek istediğiniz Firebase AI Logic API'yi arayıp seçin.

6. Kaydet'i tıklayın.

   Değişikliklerin uygulanması beş dakikayı bulabilir.

404 hatası: Firebase AI Logic genai config not found

Firebase AI Logic genai config not found şeklinde bir 404 hatası alırsanız bu genellikle Firebase AI Logic ile ilgili bir ayarın yanlış yapılandırıldığı veya eksik olduğu anlamına gelir.

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

• Firebase projenizi henüz bir Gemini API sağlayıcısı için ayarlamadınız.

  Yapılacak işlem:
  Firebase konsolunda Yapay Zeka Hizmetleri > Yapay Zeka Mantığı'na gidin. Başlayın'ı tıklayın ve ardından seçtiğiniz Gemini API sağlayıcıyı belirleyin. API'yi etkinleştirin. Firebase, projenizi bu sağlayıcı için ayarlar. İş akışını tamamladıktan sonra isteğinizi tekrar deneyin.

• Firebase AI Logic konsolunda Firebase kurulum iş akışını çok yakın zamanda tamamladıysanız Firebase AI Logic yapılandırması henüz tüm geçerli bölgelerdeki gerekli tüm arka uç hizmetlerinde kullanılamıyor olabilir.

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

404 hatası: "was not found or your project does not have access to it" modeli?

Örneğin: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."

Bu tür bir hatayı almanıza yol açabilecek birkaç farklı neden vardır.

• Geçersiz model adı

  • Neden: Belirttiğiniz model adı geçerli bir model adı değil.

  • Düzeltme: Model adınızı ve model sürümünüzü tüm desteklenen ve kullanılabilen modellerin listesiyle karşılaştırın. Model adındaki segmentleri ve bunların sırasını kontrol etmeyi unutmayın. Örneğin:

    • En yeni Gemini 3.x Pro model adı: gemini-3.1-pro-preview (yalnızca önizleme sürümünde kullanılabilir)
    • En yeni Gemini 3.x Flash model adı: gemini-3.8-flash
    • En yeni Gemini 3.x Flash‑Lite model adı: gemini-3.5-flash-lite
    • En yeni Gemini 3.x Pro Image (diğer adıyla "Nano Banana Pro") model adı: gemini-3-pro-image
    • En yeni Gemini 3.x Flash Image (diğer adıyla "Nano Banana 2") model adı: gemini-3.1-flash-image
    • En yeni Gemini 3.x Flash‑Lite Image (diğer adıyla "Nano Banana 2 Lite") model adı: gemini-3.1-flash-lite-image
    • En yeni Gemini 2.5 Flash Image (diğer adıyla "Nano Banana") model adı: gemini-2.5-flash-image

• Geçersiz konum (yalnızca Agent Platform Gemini API (formerly Vertex AI) sağlayıcısı kullanılıyorsa geçerlidir)

  • Neden: İsteğiniz, modelin kullanılamadığı bir konumdaki modele erişmeye çalışıyor olabilir.

  • Düzeltme: İsteğinizin, modelin kullanılabildiği yere erişmeye çalıştığından emin olun.

    Agent Platform Gemini API (formerly Vertex AI) işlevini kullanırken başlatma sırasında modele erişmek için isteğe bağlı olarak bir konum belirtebilirsiniz. Bir konum belirtmezseniz Firebase AI Logic varsayılan olarak aşağıdaki konumlara ayarlanır:

    • "Agent Platform" başlatma söz dizimini kullanırken: global
    • Eski "Vertex AI" başlatma söz dizimini kullanırken: us-central1

    Ancak bu varsayılan konumlarda tüm modeller desteklenmez. Bu, modele bağlı olarak başlatma sırasında belirli bir konumun açıkça ayarlanması gerekebileceği anlamına gelir.

    • Gemini Önizleme ve deneysel modeller: Yalnızca global konumunda kullanılabilir.

    • Gemini 3.x Kararlı modeller: global konumunda ve genellikle us ve eu konumlarında kullanılabilir.

    • Gemini 2.5 modelleri: Birçok konumda kullanılabilir. Gemini Live API 2.5 modellerinin global'de kullanılamadığını unutmayın.

  Modele erişim konumunu belirtme (kod snippet'leri dahil) hakkında daha fazla bilgi edinin.

429 hataları: "You exceeded your current quota, please check your plan and billing details" veya "Resource exhausted, please try again later."

Bu tür bir hatayı almanıza yol açabilecek birkaç farklı neden vardır.

• Kotenizi aşıyorsunuz veya eriştiğiniz model, diğer kullanıcılardan gelen istekler nedeniyle aşırı yüklenmiş.

  Yapılacak işlem, Gemini Developer API veya Agent Platform Gemini API (formerly Vertex AI) kullanıp kullanmadığınıza bağlıdır. Kotalar ve ek kota isteğinde bulunma hakkında daha fazla bilgi için Hız sınırları ve kotalar başlıklı makaleyi inceleyin.

  Agent Platform Gemini API (formerly Vertex AI) kullanıyorsanız Google Cloud belgelerinde 429 hata kodu ile ilgili ek bağlam ve yönergeler sağlanır.

• Faturalandırma gerektiren bir model veya özellik kullanmaya çalışıyorsunuz ancak Firebase projeniz Spark fiyatlandırma planında.

  Gemini Developer API kullanıyorsanız Gemini Developer API "ücretsiz katmanında" belirli modellere sınırlı erişim ve birçok temel özelliğe erişim elde edebilirsiniz. Bu katman, ödeme yöntemi sağlamanıza gerek kalmadan kullanmaya başlamanıza olanak tanır. Bu da Firebase projenizi kullandıkça öde Blaze fiyatlandırma planına yükseltmeniz gerekmediği anlamına gelir.

  • Bazı modeller Gemini Developer API "ücretsiz katman"da kullanılamaz ve "ücretli katman" gerektirir. Bu nedenle projeniz, kullandıkça öde Blaze fiyatlandırma planında olmalıdır. Örneğin, aşağıdaki modeller neredeyse her zaman faturalandırma gerektirir:

    • Çoğu önizleme ve deneysel model
    • Görüntü üretme modelleri ("Nano Banana" modelleri)

  • Bazı modeller, Gemini Developer API "ücretsiz katmanında" bazı temel özellikleri sunar ancak daha ileri seviye özellikleri kullanmak için "ücretli katman" gerekir. Örneğin:

    • Gemini 3.x modellerinin çoğunu kullanırken Google Search veya Google Maps ile temellendirme için faturalandırma gerekir.

  Firebase fiyatlandırma planları ve Gemini Developer API hakkında bilgi edinin.

  Daha fazla bilgi için Gemini Developer API fiyatlandırma belgeleri ve faturalandırmayla ilgili SSS bölümünü inceleyin.