Modele erişilecek konumu belirtin

Sağlayıcıya özel içeriği ve kodu bu sayfada görüntülemek için Gemini API sağlayıcınızı tıklayın.


Google'ın üretken yapay zeka modelleri belirli bölgelerde kullanılabilir. Uygunluk, gecikme, kullanılabilirlik ve dayanıklılık gereksinimlerinizi karşılamak için modele nereden erişeceğinizi seçebilirsiniz.

Firebase AI Logic kullanırken Agent Platform Gemini API (formerly Vertex AI) kullanan her isteğiniz, modele erişmek için isteğe bağlı olarak konumu içerebilir. Firebase AI Logic varsayılan konum ayarlarına sahiptir.

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

Neredeyse tüm Gemini modelleri, Agent Platform Gemini API (formerly Vertex AI) konumunu destekler. Bu, isteğinizin küresel havuzdaki herhangi bir model tarafından işleneceği anlamına gelir.global İstekleriniz için global konumunu kullanmak, modelin kapasite sınırlarına ulaşmanızı önlemeye ve "hizmet aşırı yüklendi" (503) hatalarını azaltmaya yardımcı olabilir. Ayrıca, modele bağlı olarak global konumunun kullanılması gerekebilir.

Konumun açıkça ayarlanması ne zaman gerekir?

Firebase AI Logic, konum için otomatik varsayılanlara sahiptir (örneğin, "Agent Platform" başlatma söz dizimi kullanılırken global). Ancak farklı bir konum kullanmanız gerekiyorsa veya bunu istiyorsanız kodunuzda Agent Platform Gemini API (formerly Vertex AI) arka uç hizmetinin başlatılması sırasında konumu açıkça belirtmeniz gerekir.

Modele bağlı olarak, konumun açıkça ayarlanması gerekebilir. İsteğiniz, kullanılamadığı bir konumdaki modele erişmeye çalışırsa 404 hatası alırsınız. Bu hata, modelin was not found or your project does not have access to it olduğunu belirtir.

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

Kullanılabilir tüm konumların listesini bu sayfanın ilerleyen bölümlerinde bulabilirsiniz.

Genel bilgiler ve en iyi uygulamalar

Konumlarla ilgili bazı önemli bilgileri ve en iyi uygulamaları aşağıda bulabilirsiniz:

  • Kapasite sınırları model başına, bölge başına ve dakika başına belirlenir.

  • Kapasite sınırlarına beklenmedik bir şekilde ulaşmamak için konum global özelliğini kullanabilirsiniz (modeliniz global konumunu destekliyorsa).

  • Modele eriştiğiniz konumu kontrol etmek için Firebase Remote Config kullanabilirsiniz. Bu sayede, uygulamanızın yeni bir sürümünü yayınlamadan konumu değiştirebilirsiniz.

  • global konumunu kullanmak kullanım alanınız için geçerli veya desteklenmiyorsa modellere eriştiğiniz yerleri açıkça dağıtmayı düşünebilirsiniz. Örneğin, Firebase Remote Config kullanarak konumu son kullanıcının konumuna göre ayarlayabilirsiniz.

Kod örnekleri

Firebase AI Logic, konum için otomatik varsayılanlara sahiptir (örneğin, "Agent Platform" başlatma söz dizimi kullanılırken global). Ancak farklı bir konum kullanmanız gerekiyorsa veya bunu istiyorsanız Agent Platform Gemini API (formerly Vertex AI) arka uç hizmetinin başlatılması sırasında konumu kodunuzda açıkça belirtmeniz gerekir.

LOCATION yerine bu sayfanın ilerleyen kısımlarında yer alan kullanılabilir konumlar listesindeki konum kodunu (örneğin, global veya europe-west4) girin.

Agent Platform söz dizimi

Swift 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

Kotlin 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

Java 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

Web 

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

Dart 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

Unity 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

Vertex AI söz dizimi

Swift 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexai` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))

// ...

Kotlin 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

Java 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

Web 

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

Dart 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

Unity 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

Modelin kullanılamadığı bir konum belirtirseniz modelin was not found or your project does not have access to it olduğunu belirten bir 404 hatası alacağınızı unutmayın.

Kullanılabildiği yerler

Google Cloud kullanır. bölgeler Google Cloud, müşteri verilerini yalnızca Agent Platform'daki üretken yapay zekanın genel kullanıma açık tüm özellikleri için belirttiğiniz bölgede depolar.

Agent Platform'da üretken yapay zeka aşağıdaki bölgelerde kullanılabilir. Bazı modeller ve/veya belirli sürümler her yerde kullanılamayabilir (Konum kullanılabilirliğiyle ilgili ayrıntılı bilgi için Google Cloud dokümanlarına bakın).

Aşağıdakileri göz önünde bulundurun:

  • Firebase AI Logic varsayılan olarak us-central1 konumuna ayarlanır.

  • Tüm Gemini önizleme modelleri (Live API modelleri hariç) için yalnızca global konumu desteklenir.

  • Firebase AI Logic kullanarak Gemini 3.x modellerine erişirken yalnızca global konumu desteklenir. Firebase AI Logic, us ve eu konumlarını henüz desteklemiyor.

  • Tüm Live API modelleri ve tüm Imagen modelleri için global konum desteklenmez.

Global

  • global

Amerika Birleşik Devletleri

  • Columbus, Ohio (us-east5)
  • Dallas, Teksas (us-south1)
  • Iowa (us-central1)
  • Las Vegas, Nevada (us-west4)
  • Moncks Corner, Güney Carolina (us-east1)
  • Kuzey Virginia (us-east4)
  • Oregon (us-west1)

Kanada

  • Montréal (northamerica-northeast1)

Güney Amerika

  • Sao Paulo, Brezilya (southamerica-east1)

Avrupa

  • Belçika (europe-west1)
  • Finlandiya (europe-north1)
  • Frankfurt, Almanya (europe-west3)
  • Londra, Birleşik Krallık (europe-west2)
  • Madrid, İspanya (europe-southwest1)
  • Milano, İtalya (europe-west8)
  • Hollanda (europe-west4)
  • Paris, Fransa (europe-west9)
  • Varşova, Polonya (europe-central2)
  • Zürih, İsviçre (europe-west6)

Asya-Pasifik

  • Changhua County, Tayvan (asia-east1)
  • Hong Kong, Çin (asia-east2)
  • Mumbai, Hindistan (asia-south1)
  • Seul, Kore (asia-northeast3)
  • Singapur (asia-southeast1)
  • Sidney, Avustralya (australia-southeast1)
  • Tokyo, Japonya (asia-northeast1)

Orta Doğu

  • Dammam, Suudi Arabistan (me-central2)
  • Doha, Katar (me-central1)
  • Tel Aviv, İsrail (me-west1)