Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

템플릿 전용 모드 적용

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

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

중요 고려사항

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

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

이 설정은 Firebase AI Logic의 프로젝트 전체 설정입니다.
- 프로젝트에 등록된 모든 앱에 적용됩니다.
- 시행되는 프로젝트에만 적용됩니다.
이 설정은 Firebase AI Logic를 통해 Gemini Developer API 및 Agent Platform Gemini API (formerly Vertex AI)에 대한 모든 요청에 적용됩니다.
이 설정은 서버 프롬프트 템플릿을 사용하지 않는 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 콘솔에서 템플릿 전용 모드 설정을 관리합니다.

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

Firebase 프로젝트에 템플릿 전용 모드를 적용하는 방법은 다음과 같습니다.

템플릿 전용 모드 적용을 중지하는 경우 다음 사항에 유의하세요.

Firebase 프로젝트에서 템플릿 전용 모드 적용을 중지하는 방법은 다음과 같습니다.