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

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ề khả năng tuân thủ, độ trễ, tính khả dụng và độ bền.

Khi sử dụng Firebase AI Logic, mỗi yêu cầu của bạn sử dụng Agent Platform Gemini API (formerly Vertex AI) có thể tuỳ ý bao gồm 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 chạy "Nền tảng tác nhân" mới: global
• Khi sử dụng cú pháp khởi chạy "Vertex AI" cũ: us-central1

Giới thiệu về vị trí global

Đối với hầu hết các mô hình Gemini, Agent Platform Gemini API (formerly Vertex AI) cung cấp vị trí global. Điều này có nghĩa 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 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 đạt đến hạn mức dung lượng 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 vì đây là vị trí duy nhất có sẵn cho mô hình (ví dụ: mô hình Gemini ở giai đoạn xem trước).

Khi nào cần đặ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 chạy "Nền tảng tác nhân"). 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õ ràng vị trí đó trong quá trình khởi chạy dịch vụ phụ trợ Agent Platform Gemini API (formerly Vertex AI) trong mã của bạn.

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ó mô hình đó, thì bạn sẽ gặp lỗi 404 cho biết was not found or your project does not have access to it (không tìm thấy mô hình hoặc dự án của bạn không có quyền truy cập vào mô hình đó).

• Gemini Các mô hình ở giai đoạn xem trước và thử nghiệm: Chỉ có ở vị trí global.

• Gemini 4.x và các mô hình ổn định Gemini 3.x: Có sẵn ở vị trí global và thường có ở các vị trí us và eu.

• Gemini 2.5 mô hình: Có ở nhiều vị trí. Xin lưu ý rằng các mô hình Gemini Live API 2.5 không có ở global.

Xem danh sách tất cả các vị trí có sẵn ở phần sau trên trang này.

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

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

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

• Để tránh đạt đến hạn mức 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ó ở 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í global không áp dụng được cho trường hợp sử dụng của bạn, hãy cân nhắc phân phối rõ ràng vị trí mà bạn truy cập vào mô hình (nếu mô hình có ở các vị trí khác ngoài global). 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 chạy "Nền tảng tác nhân"). 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õ ràng vị trí đó trong quá trình khởi chạy dịch vụ phụ trợ Agent Platform Gemini API (formerly Vertex AI) trong mã của bạn.

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

// ...

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

// ...

Xin lưu ý rằng nếu bạn chỉ định một vị trí không có mô hình, thì bạn sẽ gặp lỗi 404 cho biết was not found or your project does not have access to it (không tìm thấy mô hình hoặc dự án của bạn không có quyền truy cập vào mô hình đó).

Phạm vi 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 ở vùng mà bạn chỉ định cho tất cả các tính năng phát hành rộng rãi của AI tạo sinh trên Agent Platform.

AI tạo sinh trên Agent Platform có ở các khu vực sau. Một số mô hình 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 ở các vị trí sau:

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

• Gemini Các mô hình ở giai đoạn xem trước và thử nghiệm: Chỉ có ở vị trí global.

• Gemini 4.x và các mô hình ổn định Gemini 3.x: Có sẵn ở vị trí global và thường có ở các vị trí us và eu.

• Gemini 2.5 mô hình: Có ở nhiều vị trí. Xin lưu ý rằng các mô hình Gemini Live API 2.5 không có ở global.

Gemini 3.x và các mô hình sau này

Khi sử dụng Gemini 3.x trở lên, Firebase AI Logic hỗ trợ các vị trí sau:

• global
• us
• eu
• europe-west2 (Luân Đôn, Vương quốc Anh)
• asia-southeast1 (Singapore)

Để biết thông tin chi tiết về các vị trí có sẵn cho từng mô hình, hãy xem Google Cloudtài liệu.

Các mô hình thế hệ cũ

Khi sử dụng các mô hình Gemini cũ (như các mô hình 2.5), Firebase AI Logic hỗ trợ các vị trí sau:

Xin lưu ý rằng các mô hình Gemini Live API 2.5 không có ở global.

Để biết thông tin chi tiết về các vị trí có sẵn cho từng mô hình, hãy xem Google Cloudtài liệu.

Danh sách các vị trí từng có nhưng hiện đã ngừng hoạt động:

• Chưa có vị trí nào bị ngừng hoạt động