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.

템플릿 전용 모드 적용

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

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

중요 고려사항

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

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

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

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

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

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

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

Trace Explorer

템플릿 전용 모드 설정 관리

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

필수 IAM 권한 및 역할

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