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. Mỗi yêu cầu sử dụng Vertex AI Gemini API đều phải có vị trí để truy cập vào mô hình. Firebase AI Logic sẽ tự động mặc định là us-central1 cho tất cả các yêu cầu.

Đối với hầu hết các mô hình Gemini, Vertex AI Gemini API đề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á giới hạn 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.

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

Vì Firebase AI Logic tự động mặc định là us-central1 cho tất cả các yêu cầu, nê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 tạo dịch vụ phụ trợ Vertex AI Gemini API 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ó mô hình đó, 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 xem trước các mô hình: Bạn phải đặt vị trí thành global một cách rõ ràng (ngoại trừ các mô hình xem trước Live API).

• Các mô hình Gemini 3.x: Bạn phải đặt vị trí thành global một cách rõ ràng khi sử dụng Firebase AI Logic. Firebase AI Logic chưa hỗ trợ các vị trí us và eu.

• Các mô hình Gemini 2.5: Bạn không bắt buộc nhưng nên đặt vị trí một cách rõ ràng. Nếu bạn không chỉ định vị trí, giá trị mặc định sẽ là us-central1.

• Các mô hình Gemini Live API: Bạn không bắt buộc nhưng nên đặt vị trí một cách rõ ràng. Nếu bạn không chỉ định vị trí, giá trị mặc định sẽ là us-central1. Xin lưu ý rằng 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 đặt vị trí thành 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 đặt vị trí thành global không áp dụng 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 tự động mặc định là us-central1 cho tất cả các yêu cầu. 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 tạo dịch vụ phụ trợ Vertex AI Gemini API trong mã của mình.

Xin lưu ý rằng các mẫu này minh hoạ cách truy cập vào một mô hình Gemini, nhưng bạn cũng có thể chỉ định một vị trí khi truy cập vào một mô hình Imagen.

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.

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

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 Vertex AI.

AI tạo sinh trên Vertex AI 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, 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ợ.