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 durum 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, Vertex AI API projenizde 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, Cloud Storage for Firebase URL'lerini çok formatlı isteklerinize 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 bilgiyi Google Cloud dokümanlarında bulabilirsiniz.

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 gereklidir.Firebase

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

   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ırmasında 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.

5. Seçilen API'ler açılır menüsünde, Firebase AI Logic API'yi arayıp seçerek API anahtarı kullanılarak ç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ıyorsanı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 Firebase AI Logic sayfasına gidin. Başlayın'ı tıklayın ve Gemini Developer API seçeneğini belirleyin. 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 mi?

Örneğin: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3-pro-image-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ü 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:

    • Gemini 3.1 Pro önizleme modelinin adı gemini-3.1-pro-preview.
    • Gemini 3 Flash önizleme modelinin adı gemini-3-flash-preview.
    • "Nano Banana Pro" önizleme modelinin adı gemini-3-pro-image-preview.
    • "Nano Banana 2" önizleme modelinin adı gemini-3.1-flash-image-preview.
    • "Nano Banana" model adı gemini-2.5-flash-image.

• Geçersiz konum (yalnızca Vertex AI Gemini API sağlayıcısı ve önizleme veya deneysel model kullanılıyorsa geçerlidir)

  • Neden: Bir modelin önizleme veya deneysel sürümünü kullanıyorsunuz (örneğin, gemini-3.1-pro-preview ve gemini-3.1-flash-image-preview) ve global konumunu belirtmediniz.

    Vertex AI Gemini API kullanıyorsanız tüm önizleme ve deneysel Gemini modeller (Gemini Live modelleri hariç) yalnızca global konumunda kullanılabilir. Ancak Firebase AI Logic, varsayılan olarak us-central1 konumunu kullandığından bu Gemini modellerini kullanırken kodunuzda Vertex AI Gemini API arka uç hizmetini başlatırken global konumunu açıkça belirtmeniz gerekir.

  • Düzeltme: Vertex AI Gemini API hizmetini başlattığınızda konumu global belirtin. Modele erişmek için konumu belirtme (kod snippet'leri dahil) hakkında daha fazla bilgi edinin.

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

  • Neden: Erişmeye çalıştığınız konumda desteklenmeyen bir model kullanıyorsunuz.

    Vertex AI Gemini API kullanıyorsanız bazı modeller yalnızca belirli konumlarda kullanılabilir. Örneğin (ancak bunlarla sınırlı değildir):

    • Imagen modelleri, global konumunda desteklenmez.
    • Gemini Live API modelleri (ör. gemini-2.0-flash-live-preview-04-09) yalnızca us-central1 konumunda desteklenir.
    • Gemini 2.5 modelleri (gemini-2.5-pro gibi) yalnızca global konumunda, ABD'deki konumlarda ve bazı Avrupa ülkelerindeki konumlarda (ve bazen projenizde özel seçenekler varsa diğer konumlarda) kullanılabilir.

  • Düzeltme: Vertex AI Gemini API hizmetini başlatırken kullandığınız model için desteklenen bir konum belirttiğinizden emin olun. Modele erişmek için konumu belirtme (kod snippet'leri dahil) ve modeller için desteklenen konumlar hakkında daha fazla bilgi edinin.

    Firebase AI Logic öğesinin varsayılan olarak us-central1 konumuna ayarlandığını unutmayın.

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 Vertex AI Gemini API 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.

Vertex AI Gemini API kullanıyorsanız Vertex AI Gemini API dokümanlarında 429 hata kodu ile ilgili ek bağlam ve rehberlik sağlanır.Google Cloud