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

Các mô hình AI tạo sinh của Google chỉ 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ễ, khả năng hoạt độ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ể 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, nghĩa là yêu cầu của bạn sẽ được xử lý bằng 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 giới hạn dung lượng cho mô hình và giảm lỗi "dịch vụ bị quá tải" (503). Ngoài ra, tuỳ thuộc vào mô hình, bạn có thể 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 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, bạn cần chỉ định rõ 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 mình.

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

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

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

• Các mô hình Gemini 2.5: Có ở nhiều địa điểm. Xin lưu ý rằng các mô hình Gemini Live API 2.5 không có trong global.

Xem danh sách tất cả vị trí hiện có ở 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à các phương pháp hay nhất về vị trí:

• Hạn mức được áp dụng cho mỗi mô hình, mỗi khu vực và mỗi phút.

• Để tránh gặp phải giới hạn dung lượng ngoài dự kiến, hãy cân nhắc sử dụng vị trí global (nếu mô hình có sẵn ở 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 việc phân phối rõ ràng nơi bạn truy cập vào một mô hình (nếu mô hình đó có sẵn ở 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, bạn cần chỉ định rõ 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 mình.

Thay thế LOCATION bằng mã vị trí (ví dụ: global hoặc us-central1) trong danh sách vị trí có sẵn ở phần sau của 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 chỉ định một vị trí không có mô hình, bạn sẽ nhận được lỗi 404 cho biết mô hình was not found or your project does not have access to it.

Phạm vi cung cấp

Google Cloud sử dụng vùng. 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 được 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 hiện có ở những khu vực sau. Một số mô hình và/hoặc phiên bản cụ thể có thể không được cung cấp ở 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 tài liệu về Google Cloud).

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

• Firebase AI Logic mặc định là 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

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

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

• Các mô hình Gemini 2.5: Có ở nhiều địa điểm. Xin lưu ý rằng các mô hình Gemini Live API 2.5 không có trong global.

Gemini 3.x và các mẫu mới hơn

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

• global
• us
• eu

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

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

Khi sử dụng các mô hình Gemini cũ (như 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ó trong global.

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

Danh sách các vị trí trước đây có sẵn nhưng hiện đã bị từ chối:

• Chưa có địa điểm nào bị từ chối