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.

템플릿 전용 모드 적용

Firebase AI Logic을 통한 모든 Gemini API 요청이 서버 프롬프트 템플릿을 사용하도록 Firebase 프로젝트에 템플릿 전용 모드를 적용할 수 있습니다.

요청이 차단되면 응답은 403: unauthorized 오류가 됩니다.

중요 고려사항

템플릿 전용 모드에 관한 다음 중요 사항을 참고하세요.

템플릿 전용 모드가 적용된 경우

템플릿 전용 모드가 적용되면 다음 사항에 유의하세요.

이 설정은 Firebase AI Logic의 프로젝트 전체 설정입니다.
- 이 내용은 프로젝트에 등록된 모든 앱에 적용됩니다.
- 이 규칙은 시행되는 프로젝트에만 적용됩니다.
이 설정은 Firebase AI Logic를 통해 Gemini Developer API 및 Vertex AI Gemini API에 전송되는 모든 요청에 적용됩니다.
이 설정은 서버 프롬프트 템플릿을 사용하지 않는 Firebase AI Logic를 통한 모든 요청을 차단합니다. 여기에는 아직 지원되지 않는 서버 프롬프트 템플릿 기능을 사용하는 앱의 요청 차단이 포함됩니다.
이 설정은 Firebase AI Logic을 통하지 않는 프로젝트의 Gemini API 요청을 차단하지 않습니다.
Firebase AI Logic REST API를 사용하는 경우:
- 이 설정은 서버 프롬프트 템플릿 (예: templateGenerateContent 또는 templateStreamGenerateContent 사용)을 사용하는 추론 요청을 차단하지 않습니다.
- 이 설정은 템플릿 및 구성을 관리하는 요청과 같은 제어 플레인 요청을 차단하지 않습니다.
이 설정은 countTokens (Count Tokens API)에 대한 요청을 차단하지 않습니다.

템플릿 전용 모드를 적용하기 전

템플릿 전용 모드를 적용하기 전에 다음 사항에 유의하세요.

서버 프롬프트 템플릿을 사용하지 않는 앱의 기존 버전이 있는 경우:
- 이 설정은 기존 앱 버전에서 Firebase AI Logic을 통한 요청을 차단합니다.
- 템플릿 전용 모드를 적용하기 전에 모든 활성 클라이언트가 서버 프롬프트 템플릿을 사용하도록 업데이트되었는지 확인하세요.
앱에서 아직 지원되지 않는 서버 프롬프트 템플릿 기능을 사용하는 경우:
- 이 설정은 서버 프롬프트 템플릿을 사용하지 않으므로 아직 지원되지 않는 이러한 기능에 대한 Firebase AI Logic를 통한 요청을 차단합니다.
- 템플릿 전용 모드를 적용하기 전에 앱 (이전 버전 포함)에서 아직 지원되지 않는 기능을 적극적으로 사용하지 않는지 확인하세요.

템플릿 전용 모드 설정 관리

Firebase 콘솔에서 템플릿 전용 모드의 설정을 관리합니다.

필수 IAM 권한 및 역할

템플릿 전용 모드 설정을 관리하려면 firebasevertexai.configs.update 권한이 필요하며, 이 권한은 소유자, 편집자, Firebase 관리자, Firebase AI Logic 관리자 IAM 역할에 기본적으로 포함되어 있습니다.