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 của bạn sử dụng Vertex AI Gemini API phải bao gồm vị trí để truy cập vào mô hình. Firebase AI Logic tự động đặt us-central1 làm giá trị mặc định 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 hỗ trợ 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 hiện có ở 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ể bắt buộc phải sử dụng vị trí global.

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

Vì Firebase AI Logic tự động đặt us-central1 làm giá trị mặc định cho tất 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õ ràng vị trí đó trong quá trình khởi chạy 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 was not found or your project does not have access to it (không tìm thấy hoặc dự án của bạn không có quyền truy cập vào mô hình đó).

• Gemini mô hình xem trước: 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).

• Gemini 3.x mô hình: 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.

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

• Gemini Live API mô hình: Bạn có thể đặt vị trí một cách rõ ràng, nhưng nên làm như vậy. 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ả các vị trí hiện có ở 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í:

• Giới hạn dung lượng là 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 đượ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 vị trí mà 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 đặt us-central1 làm giá trị mặc định 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, bạn cần chỉ định rõ ràng vị trí đó trong quá trình khởi chạy 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 cho thấy cách truy cập vào mô hình Gemini, nhưng bạn cũng có thể chỉ định vị trí khi truy cập vào 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í hiện có ở phần sau trên 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 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 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 Vertex AI.

AI tạo sinh trên Vertex AI 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, hãy xem Google Cloud tài liệu).

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

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

• Đối với tất cả các mô hình Gemini xem trước (ngoại trừ các mô hình 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ô hình Live API và tất cả các mô hình Imagen, global vị trí không được hỗ trợ.