Modele erişilecek konumu belirtin

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ılı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

global konumu hakkında

Neredeyse tüm Gemini modelleri için Agent Platform Gemini API (formerly Vertex AI), global konumunu sunar. Bu, isteğinizin küresel havuzdaki herhangi bir model tarafından işleneceği anlamına gelir.

İstekleriniz için global konumunu kullanmak, modelin kapasite sınırlarına ulaşmanızı önleyebilir ve "hizmet aşırı yüklendi" (503) hatalarını azaltabilir. Ayrıca, modele bağlı olarak global konumunun kullanılması gerekebilir çünkü bu, model için kullanılabilen tek konumdur (örneğin, önizleme Gemini modeli).

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.

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

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

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 global konumunda (model global konumunda kullanılabiliyorsa) konumunu kullanmayı düşünebilirsiniz.

• 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 uygun değilse bir modele eriştiğiniz yeri açıkça dağıtmayı düşünebilirsiniz (model, global dışındaki konumlarda kullanılabiliyorsa). Ö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 kodunuzda Agent Platform Gemini API (formerly Vertex AI) arka uç hizmetinin başlatılması sırasında konumu 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 us-central1) girin.

// ...

// 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"))

// ...

// ...

// 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"))

// ...

// ...

// 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"));

// ...

// ...

// 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') });

// ...

// ...

// 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');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly 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"));

// ...

// ...

// 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"))

// ...

// ...

// 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"))

// ...

// ...

// 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"));

// ...

// ...

// 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') });

// ...

// ...

// 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');

// ...

// ...

// 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 aşağıdaki konumlara ayarlanır:

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

• 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 modeller: Birçok konumda kullanılabilir. Gemini Live API 2.5 modellerinin global'da kullanılamadığını unutmayın.

Gemini 3.x ve sonraki modeller

Gemini 3.x ve sonraki modellerde Firebase AI Logic aşağıdaki konumları destekler:

• global
• us
• eu

Her model için kullanılabilen konumlarla ilgili ayrıntılar için Google Cloud dokümanlarına bakın.

Eski nesil modeller

Eski Gemini modelleri (ör. 2.5 modelleri) kullanırken Firebase AI Logic aşağıdaki konumlar desteklenir:

Gemini Live API 2.5 modellerinin global'da kullanılamadığını unutmayın.

Her model için kullanılabilen konumlarla ilgili ayrıntılar için Google Cloud dokümanlarına bakın.

Daha önce kullanıma sunulan ancak artık desteklenmeyen konumların listesi:

• Henüz hiçbir konum reddedilmedi