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'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 genel 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 üzerinden gerçekleştirmektir. 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.

   settings Proje ayarları bölümünün üst kısmında bulabileceğiniz Firebase proje kimliğiniz gerekir.Firebase

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ı: 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. Bu durumda 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. Seçilen API'ler açılır menüsünde, Firebase AI Logic API'yi arayıp seçerek API anahtarıyla çağrılabilen seçili API'ler listesine ekleyin.

6. Kaydet'i tıklayın.

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

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.

404 hatası: 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 Firebase AI Logic istemci SDK'larıyla kullanılacak geçerli bir Gemini API anahtarı 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 Yapay Zeka Hizmetleri > Yapay Zeka Mantığı'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 ayarlayacaktır. İş 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.

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 neden olabilecek 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ü, desteklenen ve kullanılabilen tüm modellerin listesiyle karşılaştırın. Model adındaki segmentleri ve bunların sırasını kontrol ettiğinizden emin olun. Örneğin:

    • En yeni Gemini 3.x Pro model adı: gemini-3.1-pro-preview (yalnızca önizlemede kullanılabilir)
    • En yeni Gemini 3.x Flash model adı: gemini-3.6-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) 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 (Live API modelleri hariç, aşağıya bakın).

    • Gemini 3.x modelleri: Yalnızca Firebase AI Logic kullanılırken global konumunda kullanılabilir. Firebase AI Logic, us ve eu konumlarını henüz desteklemiyor.

    • Gemini 2.5 modeller: Birçok yerde kullanılabilir.

    • Gemini Live API modeller: Yalnızca us-central1 konumunda kullanılabilir. global konumu desteklenmiyor.

  Modele erişmek için konumu 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."

429 hataları, kotanızı aştığınızı veya eriştiğiniz modelin diğer kullanıcılardan gelen isteklerle aşırı yüklendiğini gösterir.

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 isteme 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 Agent Platform Gemini API (formerly Vertex AI) dokümanlarında 429 hata kodu ile ilgili ek bağlam ve rehberlik sağlanır.Google Cloud