The latest Gemini models, like Gemini 3.1 Flash Image (Nano Banana 2), are available to use with Firebase AI Logic! Learn more.

Gemini 2.0 Flash and Flash-Lite models will shut down on June 1, 2026. To avoid service disruption, update to a newer model like gemini-3.1-flash-lite. Learn more.

All Imagen models will shut down on June 24, 2026. Learn about migrating your apps to use Nano Banana.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Thực thi chế độ chỉ mẫu

Bạn có thể thực thi chế độ chỉ dùng mẫu cho dự án Firebase để tất cả các yêu cầu Gemini API thông qua Firebase AI Logic đều phải sử dụng mẫu lời nhắc trên máy chủ.

Khi một yêu cầu bị chặn, phản hồi sẽ là lỗi 403: unauthorized.

Những điểm quan trọng cần lưu ý

Hãy lưu ý những điểm cân nhắc quan trọng sau đây đối với chế độ chỉ có mẫu.

Khi chế độ chỉ dùng mẫu được thực thi

Khi chế độ chỉ mẫu được thực thi, hãy lưu ý những điều sau:

Đây là chế độ cài đặt trên toàn dự án cho Firebase AI Logic.
- Quy tắc này áp dụng cho tất cả các ứng dụng đã đăng ký trong dự án.
- Quy tắc này chỉ áp dụng cho dự án mà quy tắc được thực thi.
Chế độ cài đặt này áp dụng cho tất cả các yêu cầu thông qua Firebase AI Logic đến cả Gemini Developer API và Vertex AI Gemini API.
Chế độ cài đặt này sẽ chặn mọi yêu cầu thông qua Firebase AI Logic mà không sử dụng mẫu câu lệnh của máy chủ. Điều này bao gồm việc chặn các yêu cầu từ ứng dụng của bạn sử dụng các chức năng chưa được hỗ trợ cho mẫu câu lệnh của máy chủ.
Chế độ cài đặt này không chặn các yêu cầu Gemini API trong dự án của bạn không thông qua Firebase AI Logic.
Nếu bạn đang sử dụng Firebase AI Logic API REST:
- Chế độ cài đặt này không chặn các yêu cầu suy luận sử dụng mẫu câu lệnh của máy chủ (chẳng hạn như sử dụng templateGenerateContent hoặc templateStreamGenerateContent).
- Chế độ cài đặt này không chặn các yêu cầu control-plane (chẳng hạn như các yêu cầu để quản lý mẫu và cấu hình).
Chế độ cài đặt này không chặn các yêu cầu đến countTokens (Count Tokens API).

Trước khi thực thi chế độ chỉ mẫu

Hãy lưu ý những điều sau trước khi bạn thực thi chế độ chỉ dùng mẫu:

Nếu bạn có các phiên bản hiện tại của ứng dụng không sử dụng mẫu lời nhắc trên máy chủ:
- Chế độ cài đặt này sẽ chặn các yêu cầu thông qua Firebase AI Logic từ những phiên bản ứng dụng hiện có đó.
- Đảm bảo rằng tất cả các ứng dụng đang hoạt động đều được cập nhật để sử dụng mẫu lời nhắc trên máy chủ trước khi thực thi chế độ chỉ dùng mẫu.
Nếu ứng dụng của bạn sử dụng các chức năng chưa được hỗ trợ cho mẫu câu lệnh của máy chủ:
- Chế độ cài đặt này sẽ chặn các yêu cầu thông qua Firebase AI Logic đối với những chức năng chưa được hỗ trợ này vì chúng không (và không thể) sử dụng các mẫu lời nhắc của máy chủ.
- Đảm bảo rằng ứng dụng của bạn (bao gồm cả mọi phiên bản trước đây) không chủ động sử dụng bất kỳ chức năng nào chưa được hỗ trợ trước khi thực thi chế độ chỉ dùng mẫu.

Quản lý chế độ cài đặt chỉ dùng mẫu

Bạn quản lý chế độ chỉ dùng mẫu trong bảng điều khiển Firebase.

Các quyền và vai trò bắt buộc trong IAM

Để quản lý chế độ chỉ dùng mẫu, bạn cần có quyền firebasevertexai.configs.update. Theo mặc định, quyền này được cấp cho các vai trò IAM sau: Chủ sở hữu, Người chỉnh sửa, Quản trị viên Firebase và Quản trị viên Firebase AI Logic.