Bu sayfada, Gemini API ve Firebase AI Logic SDK'ları için yaygın hata kodlarıyla ilgili sorun giderme bilgileri verilmektedir.
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ızda/nesnenizde API anahtarının bulunmadığı 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ğinden emin olun. Tüm API anahtarlarınızı Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik Bilgileri panelinde görebilirsiniz.
Eşleşmediklerini fark ederseniz yeni bir Firebase yapılandırma dosyası/nesnesi alın ve uygulamanızdakini 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 ile ç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, projede Agent Platform API'si etkinleştirildiğinde gerekli hizmet aracılarının doğru şekilde otomatik temel hazırlığının yapılmadığı bir projeden kaynaklanır. Bu, bazı projelerde görülen bilinen bir sorundur ve genel bir düzeltme üzerinde çalışıyoruz.
Projenizi düzeltmek ve bu hizmet aracılarının temel hazırlığını doğru şekilde yapmak için aşağıdaki geçici çözümü uygulayabilirsiniz. Böylece çok formatlı isteklerinize Cloud Storage for Firebase URL'lerini eklemeye başlayabilirsiniz. Projenin sahibi olmanız gerekir. Bu görev grubunu projeniz için yalnızca bir kez tamamlamanız yeterlidir.
gcloud CLI ile erişim ve kimlik doğrulama.
Bunu yapmanın en kolay yolu Cloud Shell kullanmaktır. Google Cloud belgelerinde daha fazla bilgi edinebilirsiniz.İstenirse terminalde gösterilen talimatları uygulayarak gcloud CLI komutunun Firebase projenizde çalıştırılmasını sağlayın.
Firebase konsolunda settings Proje ayarları'nın üst kısmında bulabileceğiniz Firebase proje kimliğinize ihtiyacınız olacak.
Aşağıdaki komutu çalıştırarak projenizde gerekli hizmet aracılarının temel hazırlığını yapı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 ''
Hizmet aracılarının temel hazırlığının tamamlanması 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
To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check şeklinde bir 403 - PERMISSION_DENIED hatası alırsanız isteğinizde geçerli bir App Check jetonu yoktur ve genellikle kötüye kullanılan bir modele erişmeye çalışıyorsunuzdur.
Bazı üretken modellerin, kötü niyetli kişiler tarafından yaygın olarak kötüye kullanıldığı tespit edilmiştir.
App Check olmadan projeniz bu modellerin kötüye kullanımına karşı savunmasız kalır. Firebase, geliştiricilerimizi korumak için istekleriniz geçerli bir App Check jetonu içermediği sürece bu modellere erişimi engeller. Bu jetonun kullanılabilmesi için Firebase AI Logic uygulamasında App Check zorunlu kılınmalıdır.
Hatayı döndüren modele erişmek istiyorsanız aşağıdakileri yapın:
Firebase AI Logic için App Check hizmetini ayarlayın. Yerel geliştirme için App Check hata ayıklama sağlayıcısını ayarladığınızdan emin olun.
App Check ayarlarını zaten yaptıysanız bağlantılı talimatlardaki tüm adımları tamamladığınızdan emin olun.
Uygulamanızdan Firebase AI Logic adresine isteği yeniden gönderin.
Bu istek, geçerli bir App Check jetonu gönderir ve artık 403 hatası almazsınız.
Hâlâ 403 hatası mı alıyorsunuz?
App Check zorunlu kılınmışsa ve istek göndermenize rağmen 403 hatası almaya devam ediyorsanız Firebase AI Logic için tekrar oynatma korumasının zorunlu kılınıp kılınmadığını kontrol edin ("Yalnızca izleme" modu dahil).
Tekrar oynatma koruması zorunlu kılındığında, Firebase AI Logic için yalnızca sınırlı kullanım jetonları doğrulanmış olarak kabul edilir. Bu nedenle, normal oturum jetonları bu 403 hatasını gideremez. Bu sorunu çözmek için aşağıdakilerden birini yapın:
1. seçenek: Tekrar oynatma korumasını kullanmak istiyorsanız tekrar oynatma koruması ayarlarınızı doğrulayın.
Uygulamanızın kod tabanında sınırlı kullanım jetonlarını etkinleştirmeyi de içeren tekrar oynatma korumasını ayarlama ile ilgili tüm adımları tamamladığınızdan emin olun.
Firebase AI Logic adresine isteği yeniden gönderin.
2. seçenek: Tekrar oynatma korumasını kullanmak istemiyorsanız veya uygulamanızda sınırlı kullanım jetonları etkinleştirilmemişse tekrar oynatma korumasını zorunlu kılmayı iptal edebilirsiniz.
Firebase konsolunda tekrar oynatma korumasını zorunlu kılmayı iptal edin: Güvenlik > Uygulama Kontrolü > API'ler sekmesine gidin, Firebase AI Logic satırını tıklayarak genişletin, Kur'u tıklayın ve ardından iletişim kutusunda tekrar oynatma korumasını zorunlu kılmayı iptal edin.
Firebase AI Logic adresine isteği yeniden gönderin.
Uygulamanızı son kullanıcılara yayınlamadan önce bir üretim onaylama sağlayıcısı oluşturmanız (App Attest, Play Integrity veya reCAPTCHA Enterprise gibi) gerekir. Böylece App Check zorunlu kılındığında son kullanıcılarınız yapay zeka özelliğinize erişebilir.
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
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 şeklinde bir 403 - PERMISSION_DENIED hatası alırsanız Firebase projeniz etkin değil olarak tanımlanmış ve uygulamanızdan gelen isteklerde geçerli bir App Check jetonu yok demektir.
"Etkin olmayan projeler", Firebase AI Logic etkinleştirilmiş ancak son zamanlarda Firebase AI Logic kullanımı olmayan projelerdir.
App Check olmadan projeniz, Gemini API kötüye kullanımına karşı savunmasız kalır. Firebase, projenizi korumaya yardımcı olmak için istekleriniz geçerli bir App Check jetonu içerene kadar Firebase AI Logic kullanımını devre dışı bıraktı (bunun için Firebase AI Logic için App Check zorunlu kılınmalıdır).
Firebase AI Logic uygulamasını tekrar kullanmaya hazır olduğunuzda aşağıdakileri yapın:
Firebase AI Logic için App Check hizmetini ayarlayın. Yerel geliştirme için App Check hata ayıklama sağlayıcısını ayarladığınızdan emin olun.
App Check ayarlarını zaten yaptıysanız bağlantılı talimatlardaki tüm adımları tamamladığınızdan emin olun.
Uygulamanızdan Firebase AI Logic adresine isteği yeniden gönderin.
Bu istek, geçerli bir App Check jetonu gönderir ve artık 403 hatası almazsınız.
Hâlâ 403 hatası mı alıyorsunuz?
App Check zorunlu kılınmışsa ve istek göndermenize rağmen 403 hatası almaya devam ediyorsanız Firebase AI Logic için tekrar oynatma korumasının zorunlu kılınıp kılınmadığını kontrol edin ("Yalnızca izleme" modu dahil).
Tekrar oynatma koruması zorunlu kılındığında, Firebase AI Logic için yalnızca sınırlı kullanım jetonları doğrulanmış olarak kabul edilir. Bu nedenle, normal oturum jetonları bu 403 hatasını gideremez. Bu sorunu çözmek için aşağıdakilerden birini yapın:
1. seçenek: Tekrar oynatma korumasını kullanmak istiyorsanız tekrar oynatma koruması ayarlarınızı doğrulayın.
Uygulamanızın kod tabanında sınırlı kullanım jetonlarını etkinleştirmeyi de içeren tekrar oynatma korumasını ayarlama ile ilgili tüm adımları tamamladığınızdan emin olun.
Firebase AI Logic adresine isteği yeniden gönderin.
2. seçenek: Tekrar oynatma korumasını kullanmak istemiyorsanız veya uygulamanızda sınırlı kullanım jetonları etkinleştirilmemişse tekrar oynatma korumasını zorunlu kılmayı iptal edebilirsiniz.
Firebase konsolunda tekrar oynatma korumasını zorunlu kılmayı iptal edin: Güvenlik > Uygulama Kontrolü > API'ler sekmesine gidin, Firebase AI Logic satırını tıklayarak genişletin, Kur'u tıklayın ve ardından iletişim kutusunda tekrar oynatma korumasını zorunlu kılmayı iptal edin.
Firebase AI Logic adresine isteği yeniden gönderin.
Uygulamanızı son kullanıcılara yayınlamadan önce bir üretim onaylama sağlayıcısı oluşturmanız (App Attest, Play Integrity veya reCAPTCHA Enterprise gibi) gerekir. Böylece App Check zorunlu kılındığında son kullanıcılarınız yapay zeka özelliğinize erişebilir.
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ğinden emin olun. Tüm API anahtarlarınızı Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik Bilgileri panelinde görebilirsiniz.
Eşleşmediklerini fark ederseniz yeni bir Firebase yapılandırma dosyası/nesnesi alın ve uygulamanızdakini 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 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ılabilecek seçili API'ler listesine eklendiğinden emin olmanız gerekir.
Aşağıdaki adımları uygulayın:
Google Cloud konsolunda API'ler ve Hizmetler > Kimlik Bilgileri panelini açın.
Uygulamanızın kullanmak üzere yapılandırıldığı API anahtarını seçin (ör. iOS uygulaması için "iOS anahtarı").
API anahtarını düzenle sayfasında API kısıtlamaları bölümünü bulun.
Anahtarı kısıtla seçeneğinin belirlendiğinden emin olun. Anahtarınız kısıtlanmamışsa hatanın kaynağı muhtemelen bu değildir.
Seçili API'ler açılır menüsünde Firebase AI Logic API'yi arayıp seçerek API anahtarı kullanılarak çağrılabilecek seçili API'ler listesine ekleyin.
Kaydet'i tıklayın.
Değişikliklerin geçerlilik kazanması beş dakikayı bulabilir.
404 hatası: Firebase AI Logic genai config not found
Firebase AI Logic genai config not found ifadesini içeren bir 404 hatası alırsanız bu genellikle Firebase AI Logic ayarını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ı için ayarlamadınız.
Yapılması gerekenler:
Firebase konsolunda AI Services > AI Logic'e gidin. Başlayın'ı tıklayın ve tercih ettiğiniz Gemini API sağlayıcısını seçin. API'yi etkinleştirdiğinizde Firebase, projenizi bu sağlayıcı için yapılandırır. İş akışını tamamladıktan sonra isteğinizi tekrar deneyin.Firebase konsolunda Firebase AI Logic kurulum iş akışını çok yakın zamanda tamamladıysanız Firebase AI Logic yapılandırması, geçerli tüm bölgelerdeki gerekli arka uç hizmetlerinin tamamında henüz kullanılamıyor olabilir.
Yapılması gerekenler:
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 hata almanızın birkaç farklı nedeni olabilir.
Geçersiz model adı
Nedeni: Sağladığınız model adı geçerli bir model adı değil.
Düzeltme: Model adınızı ve model sürümünüzü desteklenen ve kullanılabilir tüm modeller listesiyle karşılaştırın. Model adındaki segmentleri ve sıralarını kontrol etmeyi unutmayın. Örneğin:
- En yeni Gemini 4 Hydrogen
model adı:
gemini-4-hydrogen - En yeni Gemini 4 Argon
model adı:
gemini-4-argon - En yeni Gemini 4 Carbon
model adı:
gemini-4-carbon - 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 Nano Banana 2.1
model adı:
gemini-nano-banana-2.1 - En yeni Gemini Nano Banana 2
model adı:
gemini-3.1-flash-image - En yeni Gemini Nano Banana 2 Lite
model adı:
gemini-3.1-flash-lite-image - En yeni Gemini Nano Banana Pro
model adı:
gemini-3-pro-image
- En yeni Gemini 4 Hydrogen
model adı:
Kapatılan (kullanımdan kaldırılan) model
Nedeni: Erişmeye çalıştığınız modelin kapatma (kullanımdan kaldırma) tarihi geçti ve kalıcı olarak devre dışı bırakıldı (ör. Agent Platform Gemini API (formerly Vertex AI) üzerindeki genel kullanıma yönelik Gemini 2.5 modelleri, Gemini 2.0 modelleri veya Imagen modelleri).
Düzeltme: Desteği sonlandırılan ve kapatılan modellerle ilgili SSS bölümünü inceleyin ve kodunuzu etkin bir yedek model kullanacak şekilde güncelleyin.
Geçersiz konum (yalnızca Agent Platform Gemini API (formerly Vertex AI) sağlayıcısı kullanılıyorsa geçerlidir)
Nedeni: İsteğiniz, modelin kullanılamadığı bir konumdaki modele erişmeye çalışıyor olabilir.
Düzeltme: İsteğinizin, modele kullanılabilir olduğu yerden erişmeye çalıştığından emin olun.
Agent Platform Gemini API (formerly Vertex AI) 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 nedenle, modele bağlı olarak başlatma sırasında belirli bir konumu açıkça ayarlamanız gerekebilir.
Gemini Önizleme ve deneysel modeller: Yalnızca
globalkonumunda kullanılabilir.Gemini 4.x ve Gemini 3.x kararlı modelleri:
globalkonumunda ve genellikleusveeukonumlarında kullanılabilir.Gemini Live API 2.5 modelleri: Birçok konumda kullanılabilir ancak
globalkonumunda kullanılamaz. (Genel kullanıma yönelik Gemini 2.5 modellerinin Agent Platform Gemini API (formerly Vertex AI) için kapatıldığını unutmayın.)
- "Agent Platform" başlatma söz dizimini kullanırken:
Modele erişim için konumu belirtme hakkında daha fazla bilgi edinin (kod snippet'leri dahil).
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 hata almanızın birkaç farklı nedeni olabilir.
Kotanızı aşıyorsunuz veya eriştiğiniz model diğer kullanıcıların istekleri nedeniyle aşırı yüklendi.
Yapılacak işlem, Gemini Developer API veya Agent Platform Gemini API (formerly Vertex AI) kullanmanıza bağlıdır. Kotalar ve ek kota isteğinde bulunma hakkında daha fazla bilgi için Sıklık sınırları ve kotalar bölümüne bakın.
Agent Platform Gemini API (formerly Vertex AI) kullanıyorsanız Google Cloud belgelerinde 429 hata kodu ile ilgili ek bağlam ve rehberlik 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"da belirli modellere sınırlı erişim ve birçok temel özelliğe erişim elde edebilirsiniz. Bu katman, ödeme yöntemi belirtmenize gerek kalmadan başlamanıza olanak tanır. Yani Firebase projenizi kullandıkça öde Blaze fiyatlandırma planına yükseltmeniz gerekmez.
Bazı modeller Gemini Developer API "ücretsiz katman"da kullanılamaz ve "ücretli katman" gerektirir. Bu nedenle projenizin kullandıkça öde Blaze fiyatlandırma planında olması gerekir. Örneğin, aşağıdaki modeller neredeyse her zaman faturalandırma gerektirir:
- Çoğu önizleme ve deneysel model
- Medya üreten modeller (Gemini Nano Banana modelleri gibi)
Bazı modeller, Gemini Developer API "ücretsiz katmanda" bazı temel özellikler sunar ancak daha ileri seviye özelliklerin kullanılması için "ücretli katman" gerekir. Örneğin:
- Gemini 3.x modellerinin çoğunu kullanırken
Google Search veyaGoogle Maps ile temellendirme için faturalandırma gerekir.
- Gemini 3.x modellerinin çoğunu kullanırken
Firebase fiyatlandırma planları ve Gemini Developer API hakkında bilgi edinin.
Daha fazla bilgi için Gemini Developer API fiyatlandırma belgelerini ve faturalandırmayla ilgili SSS sayfasını inceleyin.