|
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.
Kodunuzda Vertex AI Gemini API arka uç hizmetini başlatırken, isteklerinizde eriştiğiniz modelin konumunu belirtebilirsiniz. Kullanılabilir konumların listesini bu sayfanın ilerleyen bölümlerinde bulabilirsiniz.
Neredeyse tüm Gemini modellerine erişmek için Vertex AI Gemini API, global konumunu destekler. Bu, isteğinizin küresel havuzdaki herhangi bir yerde bulunan kullanılabilir bir model tarafından işleneceği anlamına gelir. İstekleriniz için konumu global olarak ayarlamak, modelin kapasite sınırlarına ulaşmanızı önlemeye ve "hizmet aşırı yüklendi" (503) hatalarını azaltmaya yardımcı olabilir.
Modele bağlı olarak bu konumun ayarlanması gerekebilir:
Gemini Önizleme modelleri: Konumun
globalolarak ayarlanması gerekir (Live API önizleme modelleri hariç).Gemini 3.x modelleri: Firebase AI Logic kullanılırken konumun
globalolarak ayarlanması gerekir.Gemini 2.5 modelleri: Konum ayarlamak isteğe bağlıdır. Bir konum belirtmezseniz varsayılan değer
us-central1olur.Gemini Live API modelleri: Konum ayarlamak isteğe bağlıdır. Bir konum belirtmezseniz varsayılan değer
us-central1olur.globalkonumunun desteklenmediğini unutmayın.
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
globalolarak ayarlayabilirsiniz (modelinizglobalkonumunu destekliyorsa).Konumu
globalolarak ayarlamak kullanım alanınız için geçerli veya desteklenmiyorsa modellere eriştiğiniz yeri 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
Bu örneklerde Gemini modeline erişim gösterildiğini ancak Imagen modeline erişirken de bir 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.
Swift
// ...
// 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")
// ...
Kotlin
// ...
// 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")
// ...
Java
// ...
// 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);
// ...
Web
// ...
// 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' });
// ...
Dart
// ...
// 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');
// ...
Unity
// ...
// 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:
Tüm Gemini önizleme modelleri (Live API modelleri hariç) için yalnızca
globalkonumu desteklenir.Firebase AI Logic kullanarak Gemini 3.x modellerine erişirken yalnızca
globalkonumu desteklenir.Tüm Live API modelleri ve tüm Imagen modelleri için
globalkonum 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)