Chỉ định vị trí để truy cập vào mô hình

Nhấp vào nhà cung cấp Gemini API để xem nội dung và mã dành riêng cho nhà cung cấp trên trang này.


Các mô hình AI tạo sinh của Google có ở một số khu vực. Bạn có thể chọn nơi truy cập vào mô hình để đáp ứng các yêu cầu về việc tuân thủ, độ trễ, tính sẵn có và độ bền.

Khi sử dụng Firebase AI Logic, mỗi yêu cầu sử dụng Agent Platform Gemini API (formerly Vertex AI) đều có thể bao gồm thông tin vị trí để truy cập vào mô hình. Firebase AI Logic có chế độ cài đặt vị trí mặc định.

  • Khi sử dụng cú pháp khởi tạo "Nền tảng đại lý" mới: global
  • Khi sử dụng cú pháp khởi tạo "Vertex AI" cũ: us-central1

Đối với hầu hết các mô hình Gemini, Agent Platform Gemini API (formerly Vertex AI) đều hỗ trợ vị trí global, tức là yêu cầu của bạn sẽ được xử lý bởi một mô hình có sẵn ở bất kỳ đâu trong nhóm mô hình toàn cầu. Việc sử dụng vị trí global cho các yêu cầu có thể giúp bạn tránh vượt quá hạn mức công suất cho mô hình và giảm lỗi "dịch vụ quá tải" (503). Ngoài ra, tuỳ thuộc vào mô hình, bạn có thể bắt buộc phải sử dụng vị trí global.

Khi nào cần phải đặt vị trí một cách rõ ràng?

Firebase AI Logic có các giá trị mặc định tự động cho vị trí (ví dụ: global khi sử dụng cú pháp khởi tạo "Nền tảng đại lý"). Tuy nhiên, nếu cần hoặc muốn sử dụng một vị trí khác, thì bạn cần chỉ định rõ vị trí đó trong quá trình khởi tạo dịch vụ phụ trợ Agent Platform Gemini API (formerly Vertex AI) trong mã của mình.

Tuỳ thuộc vào mô hình, bạn có thể bắt buộc phải đặt vị trí một cách rõ ràng. Nếu yêu cầu của bạn cố gắng truy cập vào một mô hình ở vị trí không có sẵn, thì bạn sẽ gặp lỗi 404 cho biết mô hình was not found or your project does not have access to it.

  • Gemini preview và experimental models (mô hình thử nghiệm): Chỉ có ở vị trí global (ngoại trừ mô hình Live API – xem bên dưới).

  • Các mô hình Gemini 3.x: Chỉ có ở vị trí global khi dùng Firebase AI Logic. Firebase AI Logic chưa hỗ trợ các vị trí us và eu.

  • Các mẫu Gemini 2.5: Có ở nhiều vị trí.

  • Các mẫu Gemini Live API: Chỉ có ở vị trí us-central1. Vị trí global không được hỗ trợ.

Xem danh sách tất cả vị trí có thể nhắm đến ở phần sau của trang này.

Thông tin chung và các phương pháp hay nhất

Sau đây là một số thông tin chính và phương pháp hay nhất về vị trí:

  • Hạn mức về dung lượng được tính theo từng mô hình, từng khu vực, từng phút.

  • Để tránh gặp phải giới hạn dung lượng một cách bất ngờ, hãy cân nhắc sử dụng vị trí global (nếu mô hình của bạn hỗ trợ vị trí global).

  • Hãy cân nhắc sử dụng Firebase Remote Config để kiểm soát vị trí mà bạn truy cập vào mô hình. Bằng cách đó, bạn có thể thay đổi vị trí mà không cần phát hành phiên bản mới của ứng dụng.

  • Nếu việc sử dụng vị trí của global không áp dụng được hoặc không được hỗ trợ cho trường hợp sử dụng của bạn, hãy cân nhắc việc phân phối rõ ràng nơi bạn truy cập vào các mô hình. Ví dụ: bạn có thể đặt vị trí dựa trên vị trí của người dùng cuối bằng cách sử dụng Firebase Remote Config.

Mã mẫu

Firebase AI Logic có các giá trị mặc định tự động cho vị trí (ví dụ: global khi sử dụng cú pháp khởi tạo "Nền tảng đại lý"). Tuy nhiên, nếu cần hoặc muốn sử dụng một vị trí khác, thì bạn cần chỉ định rõ vị trí đó trong quá trình khởi tạo dịch vụ phụ trợ Agent Platform Gemini API (formerly Vertex AI) trong mã của mình.

Thay thế LOCATION bằng mã vị trí (ví dụ: global hoặc europe-west4) trong danh sách các vị trí có sẵn ở phần sau của trang này.

Cú pháp Nền tảng tác nhân

Swift 

// ...

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

// ...

Kotlin 

// ...

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

// ...

Java 

// ...

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

// ...

Web 

// ...

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

// ...

Dart 

// ...

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

// ...

Unity 

// ...

// 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`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

Cú pháp Vertex AI

Swift 

// ...

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

// ...

Kotlin 

// ...

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

// ...

Java 

// ...

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

// ...

Web 

// ...

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

// ...

Dart 

// ...

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

// ...

Unity 

// ...

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

// ...

Xin lưu ý rằng nếu chỉ định một vị trí mà mô hình không có sẵn, bạn sẽ gặp lỗi 404 cho biết mô hình was not found or your project does not have access to it.

Địa điểm cung cấp

Google Cloud sử dụng các khu vực. Google Cloud chỉ lưu trữ dữ liệu khách hàng ở khu vực mà bạn chỉ định cho tất cả các tính năng AI tạo sinh được cung cấp công khai trên Agent Platform.

AI tạo sinh trên Agent Platform hiện có ở những khu vực sau. Một số mẫu và/hoặc phiên bản cụ thể có thể không có ở một số vị trí (để biết thông tin chi tiết về phạm vi cung cấp theo vị trí, hãy xem Google Cloud tài liệu).

Lưu ý những điều sau:

  • Firebase AI Logic mặc định là vị trí us-central1.

  • Đối với tất cả các mẫu Gemini xem trước (ngoại trừ các mẫu Live API), vị trí duy nhất được hỗ trợ là global.

  • Khi sử dụng Firebase AI Logic để truy cập vào các mô hình Gemini 3.x, vị trí duy nhất được hỗ trợ là global. Firebase AI Logic chưa hỗ trợ các vị trí us và eu.

  • Đối với tất cả các mẫu Live API và tất cả các mẫu Imagen, vị trí globalkhông được hỗ trợ.

Toàn cầu

  • global

Hoa Kỳ

  • Columbus, Ohio (us-east5)
  • Dallas, Texas (us-south1)
  • Iowa (us-central1)
  • Las Vegas, Nevada (us-west4)
  • Moncks Corner, South Carolina (us-east1)
  • Bắc Virginia (us-east4)
  • Oregon (us-west1)

Canada

  • Montréal (northamerica-northeast1)

Nam Mỹ

  • Sao Paulo, Brazil (southamerica-east1)

Châu Âu

  • Bỉ (europe-west1)
  • Phần Lan (europe-north1)
  • Frankfurt, Đức (europe-west3)
  • London, Vương quốc Anh (europe-west2)
  • Madrid, Tây Ban Nha (europe-southwest1)
  • Milan, Ý (europe-west8)
  • Hà Lan (europe-west4)
  • Paris, Pháp (europe-west9)
  • Warsaw, Ba Lan (europe-central2)
  • Zürich, Thuỵ Sĩ (europe-west6)

Châu Á Thái Bình Dương

  • Huyện Chương Hoá, Đài Loan (asia-east1)
  • Hong Kong, Trung Quốc (asia-east2)
  • Mumbai, Ấn Độ (asia-south1)
  • Seoul, Hàn Quốc (asia-northeast3)
  • Singapore (asia-southeast1)
  • Sydney, Úc (australia-southeast1)
  • Tokyo, Nhật Bản (asia-northeast1)

Trung Đông

  • Dammam, Ả Rập Xê Út (me-central2)
  • Doha, Qatar (me-central1)
  • Tel Aviv, Israel (me-west1)