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 sahipse

• 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ı önlemeye ve "hizmet aşırı yüklendi" (503) hatalarını azaltmaya yardımcı olabilir. Ayrıca modele bağlı olarak global konumunu kullanmak gerekebilir. Bunun nedeni, model için kullanılabilen tek konumun bu olmasıdır (ör. ö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 kullanmak 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, açıkça bir konum ayarlamak 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 4.x ve Gemini 3.x kararlı modeller: global konumunda ve genellikle us ve eu konumlarında kullanılabilir.

• Gemini 2.5 modelleri: Birçok konumda kullanılabilir. Gemini Live API 2.5 modellerinin global uygulamasında kullanılamadığını unutmayın.

Bu sayfanın ilerleyen bölümlerinde kullanılabilir tüm konumların listesini görebilirsiniz.

Genel bilgiler ve en iyi uygulamalar

Konumlarla ilgili bazı önemli bilgiler ve en iyi uygulamalar aşağıda verilmiştir:

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

• Kapasite sınırlarına beklenmedik şekilde ulaşmamak için global konumunu kullanabilirsiniz (model global konumunda kullanılabiliyorsa).

• 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 kullanmak 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 (ör. 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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

Modelin kullanılamadığı bir konum belirtirseniz modelin bulunamadığını belirten bir 404 hatası alırsınız. was not found or your project does not have access to it.

Kullanılabildiği yerler

Google Cloud, bölgeleri kullanır. 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 uygulamasında üretken yapay zeka aşağıdaki bölgelerde kullanılabilir. Bazı modeller ve/veya belirli sürümler her konumda kullanılamayabilir (Konuma göre kullanılabilirlik hakkında ayrıntılı bilgi için Google Cloud belgelerine 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 4.x ve Gemini 3.x kararlı modeller: global konumunda ve genellikle us ve eu konumlarında kullanılabilir.

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

Gemini 3.x ve sonraki modeller

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

• global
• us
• eu
• europe-west2 (Londra, Birleşik Krallık)
• asia-southeast1 (Singapur)

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

Eski nesil modeller

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

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

Her model için kullanılabilir konumlar hakkında ayrıntılı bilgi edinmek istiyorsanız Google Cloud belgelerini inceleyin.

Daha önce kullanılabilen ancak artık kullanılamayan konumların listesi:

• Henüz reddedilen konum yok