Modele erişilecek konumu belirtin

Google'ın üretken yapay zeka modelleri belirli bölgelerde kullanılabilir. Vertex AI Gemini API kullanan her isteğinizde modele erişmek için konum bilgisi yer almalıdır. Firebase AI Logic, tüm istekler için otomatik olarak us-central1 olarak ayarlanır.

Neredeyse tüm Gemini modelleri, Vertex AI Gemini API 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, tüm istekler için otomatik olarak us-central1 olarak ayarlandığından farklı bir konum kullanmanız gerekiyorsa veya kullanmak istiyorsanız kodunuzda Vertex AI Gemini API 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 preview modelleri: Konumun global olarak açıkça ayarlanması gerekir (Live API önizleme modelleri hariç).

• Gemini 3.x modelleri: Firebase AI Logic kullanılırken konumun açıkça global olarak ayarlanması gerekir. Firebase AI Logic, us ve eu konumlarını henüz desteklemiyor.

• Gemini 2.5 modelleri: Konumun açıkça ayarlanması isteğe bağlıdır ancak önerilir. Bir konum belirtmezseniz varsayılan değer us-central1 olur.

• Gemini Live API modelleri: Konumun açıkça ayarlanması isteğe bağlıdır ancak önerilir. Bir konum belirtmezseniz varsayılan değer us-central1 olur. global konumunun desteklenmediğini 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 konumu global olarak ayarlayabilirsiniz (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.

• Konumu global olarak ayarlamak kullanım alanınız için geçerli değilse 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ızın konumuna göre ayarlayabilirsiniz.

Kod örnekleri

Firebase AI Logic, tüm istekler için otomatik olarak us-central1 olarak ayarlanır. Farklı bir konum kullanmanız gerekiyorsa veya kullanmak istiyorsanız kodunuzda Vertex AI Gemini API arka uç hizmetinin başlatılması sırasında konumu açıkça belirtmeniz gerekir.

Bu örneklerde Gemini modeline erişim gösterilmektedir ancak Imagen modeline erişirken de konum belirtebileceğinizi unutmayın.

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.

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
                        .generativeModel("MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"))
        .generativeModel("MODEL_NAME");

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

// ...

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: 'MODEL_NAME' });

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// Create a `GenerativeModel` instance with a model that supports your use case
final model = ai.generativeModel(model: 'MODEL_NAME');

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "MODEL_NAME");

// ...

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 Vertex AI'daki üretken yapay zekanın genel kullanıma açık tüm özellikleri için belirttiğiniz bölgede depolar.

Vertex AI'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.