The latest Gemini models, like Gemini 3.5 Flash, are available to use with Firebase AI Logic! Learn more.

Gemini 2.0 Flash and Flash-Lite models were 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ỉ mẫu cho dự án Firebase để tất cả các Gemini API yêu cầu thông qua Firebase AI Logic đều phải sử dụng mẫu lời nhắc 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 quan trọng sau đây đối với chế độ chỉ mẫu.

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

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

Chế độ cài đặt này là chế độ cài đặt trên toàn dự án cho Firebase AI Logic.
- Chế độ này áp dụng cho tất cả các ứng dụng đã đăng ký trong dự án.
- Chế độ này chỉ áp dụng cho dự án mà chế độ này đượ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 đối với cả Gemini Developer API và Vertex AI Gemini API.
Chế độ cài đặt này chặn mọi yêu cầu thông qua Firebase AI Logic mà không sử dụng mẫu lời nhắc máy chủ. Điều này bao gồm cả việc chặn các yêu cầu từ ứng dụng của bạn sử dụng các tính năng chưa được hỗ trợ cho mẫu lời nhắc máy chủ.
Chế độ cài đặt này không chặn Gemini API yêu cầu trong dự án của bạn mà 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 lời nhắc 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 mặt phẳng điều khiển (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 đối với 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ỉ mẫu:

Nếu bạn có các phiên bản hiện có của ứng dụng mà không sử dụng mẫu lời nhắc 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ó đó.
- Hãy đảm bảo rằng tất cả các ứng dụng khách đang hoạt động đều được cập nhật để sử dụng mẫu lời nhắc máy chủ trước khi thực thi chế độ chỉ mẫu.
Nếu ứng dụng của bạn sử dụng các tính năng chưa được hỗ trợ cho mẫu lời nhắc 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 tính năng chưa được hỗ trợ này vì chúng không (và không thể) sử dụng mẫu lời nhắc máy chủ.
- Hãy đả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ỳ tính năng nào chưa được hỗ trợ đó trước khi thực thi chế độ chỉ mẫu.

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

Bạn quản lý chế độ cài đặt cho chế độ chỉ mẫu trong bảng điều khiển Firebase.

Vai trò và quyền IAM bắt buộc

Để quản lý chế độ cài đặt chỉ mẫu, bạn cần có quyền firebasevertexai.configs.update. Quyền này được đưa vào theo mặc định trong 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.