指定存取模型的位置

按一下 Gemini API 供應商，即可在這個頁面查看供應商專屬內容和程式碼。


Google 生成式 AI 模型僅在特定區域提供。

在程式碼中初始化 Vertex AI Gemini API 後端服務時，您可以選擇性指定要在要求中存取的模型位置。如未指定位置，預設值為 us-central1。 請參閱本頁稍後的可用地點清單。

瞭解 global 位置

如要存取 Gemini 2.0 和 Gemini 2.5 模型，Vertex AI Gemini API 支援 global 位置，也就是說，您的要求會由全球集區中任何可用的模型處理。將要求的位置設為 global，可提高整體可用性，同時減少資源耗盡 (429) 錯誤。

此外，2025 年 6 月後發布的Gemini 2.5 預覽和實驗模型通常只能在 global 位置存取。

程式碼範例

請注意，這些範例顯示存取 Gemini 模型，但您也可以在存取 Imagen 模型時指定位置。

請將 LOCATION 替換為位置代碼 (例如 europe-west4)，該代碼位於本頁稍後的可用位置清單中。

Swift 

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify the 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 the 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 the 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 the 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 the 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 the 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");

// ...

服務地區

Google Cloud 使用 區域。 Google Cloud 只會將客戶資料儲存在您為 Vertex AI 上所有正式發布的 Generative AI 功能指定的區域。

均優先於 Firebase 說明文件中所述的任何資訊。

Vertex AI 的生成式 AI 適用於下列區域。 部分機型和/或特定版本可能僅適用於部分地區 (如需詳細的適用地區資訊，請參閱 Google Cloud 說明文件)。

Gemini 2.0 和 Gemini 2.5 型號 (Gemini 2.0 Flash Live 除外) 也適用於 global 地點。Imagen 模型不支援 global 位置。

美國

  • 美國俄亥俄州哥倫布 (us-east5)
  • 德州達拉斯 (us-south1)
  • 愛荷華州 (us-central1)
  • 內華達州拉斯維加斯 (us-west4)
  • 美國南卡羅來納州蒙克斯科納 (us-east1)
  • 北維吉尼亞州 (us-east4)
  • 奧勒岡州 (us-west1)

加拿大

  • 蒙特婁 (northamerica-northeast1)

南美洲

  • 巴西聖保羅 (southamerica-east1)

歐洲

  • 比利時 (europe-west1)
  • 芬蘭 (europe-north1)
  • 德國法蘭克福 (europe-west3)
  • 英國倫敦 (europe-west2)
  • 西班牙馬德里 (europe-southwest1)
  • 義大利米蘭 (europe-west8)
  • 荷蘭 (europe-west4)
  • 法國巴黎 (europe-west9)
  • 波蘭華沙 (europe-central2)
  • 瑞士蘇黎世 (europe-west6)

亞太地區

  • 臺灣彰化縣 (asia-east1)
  • 中國香港 (asia-east2)
  • 印度孟買 (asia-south1)
  • 韓國首爾 (asia-northeast3)
  • 新加坡 (asia-southeast1)
  • 澳洲雪梨 (australia-southeast1)
  • 日本東京 (asia-northeast1)

中東

  • 沙烏地阿拉伯達曼 (me-central2)
  • 卡達杜哈 (me-central1)
  • 以色列特拉維夫 (me-west1)