FAQ 및 문제 해결

Gemini Developer API과 Agent Platform Gemini API (formerly Vertex AI) 사용의 차이점은 무엇인가요?

다음 표에는 액세스 방식과 관계없이 두 'Gemini API' 제공업체 간의 중요한 차이점이 나열되어 있습니다.

¹ 두 API 제공업체의 종량제 가격이 다릅니다(각 문서에서 자세히 알아보기).

² Gemini Developer API의 파일 API는 Firebase AI Logic SDK를 통해 지원되지 않습니다.

다음 표에는 두 'Gemini API' 제공업체에 대해 자주 묻는 기능의 사용 가능 여부가 나와 있습니다. 이 표는 Firebase AI Logic 클라이언트 SDK를 사용하는 경우에만 적용됩니다.

Gemini Developer API와 Agent Platform Gemini API (formerly Vertex AI)을 모두 사용할 수 있나요?

예, Firebase 프로젝트에서 'Gemini API' 제공업체를 모두 사용 설정할 수 있으며 앱 자체에서 두 API를 모두 사용할 수 있습니다.

코드에서 API 제공업체 간에 전환하려면 코드에서 백엔드 서비스를 적절하게 설정하면 됩니다.

'Vertex AI'를 'Agent Platform'으로 리브랜딩하려면 어떤 변경사항이 필요한가요?

2026년 중반에 Google Cloud는 'Vertex AI'를 'Gemini Enterprise Agent Platform' (또는 'Agent Platform')으로 리브랜딩했습니다. Firebase 생태계에서는 이 서비스를 'Agent Platform Gemini API'라고 합니다.

Google Cloud의 경우 리브랜딩에 다음이 포함되었습니다. 다른 변경사항도 있지만 Firebase AI Logic에는 적용되지 않습니다.

• 제품의 브랜드가 'Vertex AI'에서 'Gemini Enterprise Agent Platform'(또는 'Agent Platform')으로 변경되었습니다. 여기에는 Google Cloud 콘솔 및 문서의 새 URL이 포함됩니다.

• API의 표시 이름을 'Vertex AI API'에서 'Agent Platform API'로 변경 서비스 이름은 aiplatform.googleapis.com으로 동일하게 유지됩니다.

• 'Vertex AI Studio'를 'Agent Studio'로 리브랜딩

• 기본 API 또는 지원되는 모델의 기능은 변경되지 않습니다.

Firebase AI Logic SDK의 경우 'Gemini API' 백엔드 서비스의 초기화 구문을 업데이트하고 이 새 구문을 사용할 때 모델에 액세스하기 위한 기본 위치를 업데이트하여 리브랜딩을 수용했습니다.

• 'Gemini API' 백엔드 서비스의 새로운 초기화 구문:

  Swift

  vertexai를 agentPlatform로 변경합니다.
  Apple 플랫폼용 Firebase SDK v12.17.0 이상에서 사용할 수 있습니다.

  이전

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexai` syntax, the default location is `us-central`, so
  // specifying a location is usually required since most models are *not* supported in `us-central`.
  let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))
  
  // ...
  

  이후

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))
  
  // ...
  

  Kotlin

  vertexAI를 agentPlatform로 변경합니다.
  Android용 Firebase AI Logic SDK v17.15.0 이상(Firebase Android BoM v34.17.0 이상)에서 사용할 수 있습니다.

  이전

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central`, so
  // specifying a location is usually required since most models are *not* supported in `us-central`.
  val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
  
  // ...
  

  이후

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))
  
  // ...
  

  Java

  vertexAI를 agentPlatform로 변경합니다.
  Android용 Firebase AI Logic SDK v17.15.0 이상(Firebase Android BoM v34.17.0 이상)에서 사용할 수 있습니다.

  이전

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central`, so
  // specifying a location is usually required since most models are *not* supported in `us-central`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));
  
  // ...
  

  이후

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));
  
  // ...
  

  Web

  VertexAIBackend를 AgentPlatformBackend로 변경합니다.
  Firebase JS SDK v12.17.0 이상에서 사용할 수 있습니다.

  이전

  import { getAI, getGenerativeModel, VertexAIBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
  // specifying a location is usually required since most models are *not* supported in `us-central`.
  const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });
  
  // ...
  

  이후

  import { getAI, getGenerativeModel, AgentPlatformBackend } from "firebase/ai";
  
  // ...
  
  // Initialize FirebaseApp
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `AgentPlatformBackend` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });
  
  // ...
  

  Dart

  vertexAI를 agentPlatform로 변경합니다.
  Flutter용 Firebase AI Logic 플러그인 v3.15.0 이상(Firebase Flutter BoM v4.18.0 이상)에서 사용할 수 있습니다.

  이전

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `vertexAI` syntax, the default location is `us-central`, so
  // specifying a location is usually required since most models are *not* supported in `us-central`.
  final ai = await FirebaseAI.vertexAI(location: 'LOCATION');
  
  // ...
  

  이후

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the `agentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');
  
  // ...
  

  Unity

  VertexAI를 AgentPlatform로 변경합니다.
  Firebase SDK for Unity v13.15.0 이상에서 사용할 수 있습니다.

  이전

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
  // For the legacy `VertexAI` syntax, the default location is `us-central`, so
  // specifying a location is usually required since most models are *not* supported in `us-central`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));
  
  // ...
  

  이후

  // ...
  
  // Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
  // For the `AgentPlatform` syntax, the default location is `global`, so
  // specifying a location is usually optional since most models are supported in `global`.
  var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));
  
  // ...
  

• 새 초기화 구문을 사용할 때 모델에 액세스하는 새로운 기본 위치:

  새로운 '에이전트 플랫폼' 초기화 구문을 사용하면 위치가 기본적으로 global로 설정됩니다.

  이 변경사항은 거의 모든 Gemini 모델이 global에서 지원되고 Google Cloud에서 대부분의 Gemini 모델의 새 출시를 위한 us-central1 위치를 더 이상 지원하지 않기 때문에 적용되었습니다.

필수 API는 무엇인가요? 사용 설정 방법

Gemini Developer API와 함께 Firebase AI Logic SDK를 사용하려면 프로젝트에서 다음 두 API가 사용 설정되어 있어야 합니다.

• Gemini Developer API회(generativelanguage.googleapis.com)
• Firebase AI Logic API (firebasevertexai.googleapis.com)

Firebase 콘솔을 사용하여 다음 두 API를 사용 설정해야 합니다.

1. Firebase 콘솔에서 AI 서비스 > AI 로직으로 이동합니다.

2. 시작하기를 클릭합니다.

3. Gemini Developer API를 시작하려면 선택하세요.

   그러면 두 API를 사용 설정하는 안내식 워크플로가 실행됩니다. 또한 Firebase는 Gemini API 사용을 승인하기 위해 Google 관리 서비스 계정 (P4SA)을 프로비저닝하고 Firebase AI Logic API를 Firebase API 키의 허용 목록에 추가합니다.

Firebase 프로젝트에서 API를 사용 중지하는 방법

Firebase AI Logic의 경우 선택한 Gemini API 제공업체를 사용하도록 Firebase 프로젝트를 최대한 쉽게 설정할 수 있도록 노력하고 있습니다. 여기에는 Firebase 콘솔의 안내 워크플로와 같은 특정 여정 중에 Firebase 프로젝트에서 필수 API를 사용 설정하는 것이 포함됩니다.

하지만 Firebase AI Logic 또는 Gemini API 제공업체 중 하나를 사용하지 않기로 결정한 경우 Firebase 프로젝트에서 연결된 API를 사용 중지할 수 있습니다.

Firebase AI Logic을 사용하는 데 어떤 권한이 필요할 수 있나요?

Firebase AI Logic을 사용할 때 지원되는 모델은 무엇인가요?

지원되는 모델 목록을 참고하세요. SDK에 새로운 기능이 자주 추가되므로 이 FAQ (출시 노트, 블로그, 소셜 게시물 포함)에서 업데이트를 확인하세요.

• Firebase AI Logic는 다음 모델을 지원합니다.

  • Gemini Developer API

    • 대부분의 Gemini 및 Imagen 파운데이션 모델

    Gemini Developer API은 액세스 방식과 관계없이 특정 안정적인 Imagen 모델만 지원합니다.

  • Agent Platform Gemini API (formerly Vertex AI)

    • 대부분의 Gemini 및 Imagen 파운데이션 모델

• Firebase AI Logic은 선택한 Gemini API 제공업체와 관계없이 다음 모델을 지원하지 않습니다.

  • 미세 조정된 모델

  • 모델, Veo 모델, Lyria 모델, 로봇 공학 모델, 컴퓨터 사용 모델, Gemini Omni 모델 또는 Gemini Flash Cyber 모델을 삽입하는 경우

  • 이전 Imagen 모델 또는 imagen-3.0-capability-001

모델이 종료 (지원 중단)되면 어떻게 해야 하나요?

Google에서는 안정적인 모델 버전을 출시할 때 모델을 종료 (퇴직)하기 최소 12개월 전에 이 버전을 사용할 수 있도록 노력합니다. 하지만 Agent Platform Gemini API (formerly Vertex AI)의 경우 일부 안정 모델은 단기 사용 가능만 제공되므로 대체 모델이 출시된 후 45일 이내에 종료 (지원 중단)될 수 있습니다.

모델의 종료일은 어디에서 확인할 수 있나요?

모델의 종료일을 확인할 수 있는 방법은 다음과 같습니다.

• 출시 시점: Gemini API 제공업체 문서와 Firebase 문서(지원되는 모델 페이지 참고)의 여러 위치에 각 모델의 예상 종료 날짜가 나열됩니다.

• 종료일이 다가옴: Google에서 적절한 프로젝트 구성원에게 이메일을 보내고 출시 노트 및 기타 채널에 예정된 종료에 관한 알림을 게시합니다 (예: Gemini 1.5 및 1.0 안정화 모델의 종료일 알림).

사용 중인 모델이 종료될 예정인 경우 어떻게 해야 하나요?

1. 적합한 현재 지원되는 모델과 모델 이름을 찾습니다.

2. 폐쇄일 전에 앱에서 사용하는 모델 이름을 업데이트하세요. 그렇지 않으면 해당 모델에 대한 요청이 404 오류로 실패합니다.

   • GenerativeModel, LiveModel 또는 ImagenModel 인스턴스를 생성할 때 초기화 중에 모델 이름을 설정합니다. Firebase Remote Config 또는 서버 프롬프트 템플릿 사용에 관한 아래의 중요한 권장사항을 검토하세요.

   • Firebase AI Logic를 사용할 때는 실제로 모델을 호출하는 코드를 수정할 필요가 일반적으로 없습니다.

     Gemini 3.x 모델의 경우 샘플링 파라미터 (온도, Top-K, Top-P)는 지원 중단됩니다.

3. 앱을 테스트하여 응답이 여전히 예상대로인지 확인합니다.

Gemini 2.5 안정화 모델 - 종료일 및 대체

• Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash‑Lite

  gemini-2.5-pro
gemini-2.5-flash
gemini-2.5-flash-lite
gemini-2.5-flash-image('Nano Banana'라고도 함)

  • 일반 사용 모델의 경우 종료 날짜는 선택한 Gemini API 제공업체에 따라 다릅니다.

    • Gemini Developer API (Google AI): 2026년 10월 16일
    • Agent Platform Gemini API (formerly Vertex AI): 2026년 10월 20일

  • 이미지 생성 모델 (Nano Banana)의 경우 선택한 Gemini API 제공업체와 관계없이 종료일은 2026년 10월 2일로 동일합니다.

  다른 'Nano Banana' 모델과 안정적인 Gemini Live API 2.5 모델은 영향을 받지 않습니다.

대체: 새 Gemini 3.x 모델(예: gemini-3.6-flash 또는 gemini-3.1-flash-image) 중 하나를 사용하도록 마이그레이션합니다.

Imagen 안정화 모델 - 종료일 및 대체

• 모든 Imagen 모델은 2026년 8월 17일에 종료될 예정입니다 (이전의 2026년 6월 30일에서 종료일이 연장됨).

대체: Gemini 이미지 모델('Nano Banana' 모델)을 사용하도록 앱을 이전하세요.

Gemini 2.0 안정화 모델 - 종료일 및 대체

• Gemini 2.0 Flash 및 Gemini 2.0 Flash‑Lite:

  gemini-2.0-flash-001 (및 자동 업데이트된 별칭 gemini-2.0-flash)
  gemini-2.0-flash-lite-001 (및 자동 업데이트된 별칭 gemini-2.0-flash-lite)

  • 2026년 2월 6일: 이전에 모델을 사용한 적이 없는 프로젝트에서 더 이상 이러한 모델을 사용할 수 없습니다.

  • 2026년 3월 31일: 이러한 모델이 종료됩니다.

  안정적인 Gemini Live API 2.0 모델은 영향을 받지 않습니다.

대체: 새로운 Gemini 3.x 모델(예: gemini-3.1-flash-lite) 중 하나를 사용하도록 이전합니다.

Gemini 1.5 및 1.0 안정화 모델 - 종료일 및 대체

• Gemini 1.5 Pro 모델:

  • gemini-1.5-pro-002 (및 gemini-1.5-pro): 2025년 9월 24일
  • gemini-1.5-pro-001: 2025년 5월 24일

• Gemini 1.5 Flash 모델:

  • gemini-1.5-flash-002 (및 gemini-1.5-flash): 2025년 9월 24일
  • gemini-1.5-flash-001: 2025년 5월 24일

• Gemini 1.0 Pro Vision 모델: 2025년 4월 21일(이전 일정: 2025년 4월 9일)

• Gemini 1.0 Pro 모델: 2025년 4월 21일(이전 일정: 2025년 4월 9일)

대체: 새 Gemini 3.x 모델(예: gemini-3.1-flash-lite) 중 하나를 사용하도록 이전합니다.

Firebase AI Logic은 모델 학습에 내 데이터를 사용하나요?

데이터 거버넌스 및 책임감 있는 AI를 참고하세요.

사용자별 비율 한도를 설정하는 방법

기본적으로 Firebase AI Logic는 사용자별 요청 한도를 분당 100개 요청 (RPM)으로 설정합니다.

사용자별 비율 제한을 조정하려면 Firebase AI Logic API의 할당량 설정을 조정해야 합니다.

Firebase AI Logic API 할당량에 대해 자세히 알아보세요. 이 페이지에서 할당량을 확인하고 수정하는 방법도 알아볼 수 있습니다.

지연 시간과 높은 토큰 사용량을 줄이는 방법

지연 시간이 길거나 토큰 사용량이 많은 경우 사용 중인 모델의 사고 수준 구성 때문일 수 있습니다.

Gemini 3 이상의 모델은 항상 내부 '사고 과정'을 사용하여 추론 및 다단계 계획 능력을 크게 향상하므로 코딩, 고급 수학, 데이터 분석과 같은 복잡한 작업에 매우 효과적입니다.

하지만 작업에 따라 높은 수준의 사고가 필요하지 않은 경우도 있으므로 낮은 수준의 사고를 사용하도록 모델을 구성할 수 있습니다. 사고 수준을 낮추면 지연 시간과 토큰 사용량을 줄일 수 있습니다. 모델에 필요한 사고 능력을 결정하려면 작업 난이도 비교를 검토하세요.

대부분의 Gemini 3 이상 모델의 경우 기본 사고 수준이 HIGH로 설정됩니다.

멀티모달 요청에 MIME 유형이 필요한가요? (예: 이미지, PDF, 동영상, 오디오 입력)

예. 각 멀티모달 요청에서 항상 다음을 제공해야 합니다.

• 파일의 mimeType입니다. 아래 예외를 참고하세요.

• 파일입니다. 파일을 인라인 데이터로 제공하거나 URL을 사용하여 파일을 제공할 수 있습니다.

지원되는 입력 파일 및 요구사항에서 지원되는 입력 파일 형식, MIME 유형 지정 방법, 파일을 제공하는 두 가지 옵션에 대해 알아보세요.

요청에 MIME 유형을 포함하는 예외

MIME 유형을 제공하지 않아도 되는 예외는 네이티브 Android 및 Apple 플랫폼 앱의 요청에 대한 인라인 이미지 입력입니다.

Android 및 Apple 플랫폼용 Firebase AI Logic SDK는 요청에서 이미지를 처리하는 간소화된 플랫폼 친화적인 방법을 제공합니다. 모든 이미지(형식과 관계없음)는 서버로 전송되기 전에 클라이언트 측에서 80% 품질의 JPEG로 변환됩니다. 즉, Android 및 Apple 플랫폼 SDK를 사용하여 이미지를 인라인 데이터로 제공하는 경우 요청에서 MIME 유형을 지정할 필요가 없습니다.

이 단순화된 처리는 요청에서 base64로 인코딩된 이미지를 전송하는 예시의 Firebase AI Logic 문서에 나와 있습니다.

이 기능에 관한 플랫폼별 추가 정보는 다음과 같습니다.

• Android:

  • 이미지를 인라인 데이터로 포함하는 멀티모달 프롬프트에서 플랫폼 네이티브 이미지 유형 (Bitmap)을 처리하는 간소화된 방식을 활용할 수 있습니다(예 참고).

  • 이미지 형식과 변환을 더 세밀하게 제어하려면 이미지를 InlineDataPart로 제공하고 특정 MIME 유형을 제공하면 됩니다. 예를 들면 다음과 같습니다.

    content { inlineData(/* PNG as byte array */, "image/png") }

• Apple 플랫폼의 경우:

  • 이미지를 인라인 데이터로 포함하는 멀티모달 프롬프트에서 플랫폼 네이티브 이미지 유형 (UIImage, NSImage, CIImage, CGImage)을 처리하는 간소화된 방법을 활용할 수 있습니다(예 참고).

  • 이미지 형식과 변환을 더 세밀하게 제어하려면 이미지를 InlineDataPart로 제공하고 특정 MIME 유형을 제공하면 됩니다. 예를 들면 다음과 같습니다.

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

Firebase AI Logic: Google 이미지 검색을 사용한 그라운딩, 모델 미세 조정, 임베딩 생성, 시맨틱 검색을 사용할 때 이러한 기능을 사용할 수 있나요?

다음 기능은 다양한 모델과 API 제공업체에서 지원되지만 Firebase AI Logic를 사용하는 경우에는 사용할 수 없습니다.

• Google 이미지 검색을 사용한 그라운딩
• 모델 미세 조정
• 임베딩 생성
• 시맨틱 검색

이를 기능 요청으로 추가하거나 기존 기능 요청에 투표하려면 Firebase UserVoice를 방문하세요.

이름이 'Vertex AI in Firebase'에서 'Firebase AI Logic'(으)로 변경된 이유는 무엇인가요?

2024년에 Google은 Agent Platform Gemini API (formerly Vertex AI)와 Firebase 프록시 게이트웨이를 모두 사용하여 API를 악용으로부터 보호하고 다른 Firebase 제품과의 통합을 지원하는 Firebase 클라이언트 SDK 세트를 출시했습니다. 제품 이름은 'Vertex AI in Firebase'였으며, 이 제품 이름은 당시 제품에서 사용할 수 있는 사용 사례를 정확하게 설명했습니다.

하지만 이후 제품의 기능을 확장했습니다. 예를 들어 2025년 5월 현재 Google은 Firebase App Check와의 통합을 사용하여 Gemini Developer API를 악용으로부터 보호하는 기능을 비롯해 Gemini Developer API를 지원합니다.

따라서 'Vertex AI in Firebase'라는 이름이 더 이상 확장된 제품 범위를 정확하게 나타내지 않습니다. 따라서 새로운 이름인 Firebase AI Logic은 진화하는 기능 세트를 더 잘 반영하며 향후 제품을 계속 확장할 수 있습니다.

이전 가이드를 확인하여 Firebase AI Logic의 모든 최신 기능을 사용하고 Gemini Developer API를 선택적으로 사용하기 시작하세요.

Apple 플랫폼의 Swift 앱 - 모듈 이름이 FirebaseAI에서 FirebaseAILogic로 변경된 경우 어떻게 해야 하나요?

Apple 플랫폼 앱의 경우 Firebase SDK v12.5.0부터 Firebase AI Logic가 이제 FirebaseAILogic 모듈에 따라 배포됩니다. 이번 변경사항은 이전 버전과 호환되도록 적용되었습니다.

변경 이유

이전에는 이 서비스를 FirebaseAI 모듈로 배포했습니다. 하지만 다음과 같은 이유로 이름을 FirebaseAILogic로 변경해야 했습니다.

• 바이너리 배포에서 문제를 일으키는 모듈과 클래스 간의 이름 충돌을 방지합니다.

• 향후 기능 개발에 Swift 매크로를 사용할 수 있도록 지원합니다.

v12.5.0 이상으로 업그레이드하는 경우 어떻게 해야 하나요?

모듈 이름이 FirebaseAILogic로 변경되어도 이전 버전과 호환되므로 중단되지 않습니다. 하지만 향후 주요 Firebase SDK 호환성 변경사항 출시와 함께 이전 모듈이 삭제될 수 있습니다(현재 시기는 미정).

이 모듈 이름 변경에는 필요한 변경사항이 없지만 다음을 권장합니다.

1. Swift PM 종속 항목을 선택할 때는 FirebaseAI 대신 FirebaseAILogic를 선택합니다.

2. import 문을 FirebaseAI 대신 FirebaseAILogic로 변경합니다.

앱의 모든 공개 버전에 App Check를 적용해야 하나요?

예, Firebase AI Logic를 사용하는 앱의 모든 공개 버전에 App Check를 적용해야 합니다.

App Check은 가능한 한 빨리 시행해야 합니다. 특히 앱을 공개적으로 사용 가능한 소스 코드 관리 시스템에 커밋하거나, 앱을 공유하거나, 앱을 공개적으로 사용 가능하게 만들기 전에 시행해야 합니다.

앱의 코드베이스에 App Check를 바로 구현하면 모든 앱 버전에서 유효한 App Check 토큰을 전송할 수 있습니다. 유효한 토큰을 전송하지 않는 요청은 인증되지 않은 것으로 간주되며 App Check가 적용되면 차단됩니다.

App Check가 구현되지 않은 앱 버전을 이미 최종 사용자에게 출시한 경우 이미 출시된 앱에 App Check를 구현하고 시행하는 방법에 관한 FAQ를 참고하세요.

이미 출시된 앱에 App Check를 구현하고 적용하려면 어떻게 해야 하나요?

App Check가 구현되지 않은 앱 버전의 경우 이러한 버전에서 Firebase AI Logic에 대한 요청에는 유효한 App Check 토큰이 없으며 미확인으로 간주됩니다. AI Logic에 App Check이 적용되면 이러한 요청은 차단됩니다.

App Check가 없는 이미 출시된 앱에서 서비스 중단을 방지하려면 App Check를 적용하기 전에 다음 단계를 따르세요.

1. 가능한 한 빨리 앱에 증명 제공자를 구현하세요.

   • Apple 플랫폼: DeviceCheck 또는 App Attest

   • Android: Play Integrity

   • 웹: reCAPTCHA Enterprise

   • Flutter: 위의 모든 기본 제공자 지원

   • Unity: 위의 모든 기본 제공자 지원

2. App Check를 시행해도 안전한 시기를 결정하는 데 도움이 되도록 앱의 요청을 모니터링합니다.

   예를 들어 거의 모든 최근 요청이 확인된 클라이언트의 요청인 경우 App Check를 적용하는 것이 좋습니다.

3. Firebase AI Logic에 App Check 적용

4. App Check가 적용되는 로컬 개발의 경우 App Check 적용을 유지하면서 증명을 우회하도록 App Check 디버그 프로바이더를 구성합니다. 플랫폼별 설정 안내를 참고하세요. iOS+ | Android | 웹 | Flutter | Unity

Gemini Developer API 및 Firebase AI Logic의 보안 업그레이드 (2026년 중반)는 무엇이었나요?

이전에는 Gemini Developer API에서 Gemini Developer API(generativelanguage.googleapis.com) 사용을 승인하기 위해 표준 Gemini API 키를 사용했습니다. Firebase AI Logic를 사용 설정하고 Gemini Developer API를 사용하기로 선택한 경우 Firebase에서 Gemini Developer API로 제한된 Gemini API 키를 만들었습니다. 이 키의 이름은 Gemini Developer API key (auto created by Firebase)입니다.

2026년 중반부터 Gemini Developer API가 '인증 (auth) 키'(기본적으로 서비스 계정)라는 더 안전한 대안으로 업그레이드됩니다. Firebase AI Logic도 함께 업그레이드되었습니다. 표준 Gemini API 키를 사용하는 대신 이제 Firebase AI Logic에서 Google 관리 서비스 계정 (P4SA)을 사용하여 Gemini Developer API의 승인을 처리합니다.
Firebase AI Logic Service Agent (service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com)

기존 프로젝트와 새 프로젝트 모두 Firebase AI Logic를 통해 Gemini Developer API에 액세스하는 경우 2026년 중반부터 이러한 보안 업그레이드를 활용하기 위해 별도로 취해야 할 조치는 없습니다.

Gemini API 키를 '인증 (auth) 키'로 이전해야 하나요?

기존 프로젝트와 새 프로젝트 모두 Firebase AI Logic를 통해 Gemini Developer API에 액세스하는 경우 2026년 중반부터 보안 업그레이드 (예: '인증 (auth) 키'로의 마이그레이션)를 활용하기 위해 별도로 취하셔야 할 조치는 없습니다.

개발자를 대신하여 Firebase AI Logic는 Gemini Developer API가 '승인 (auth) 키'를 요구하도록 전환하는 데 필요한 모든 보안 변경사항을 자동으로 처리합니다.

2026년 중반부터 Firebase AI Logic는 더 이상 표준 Gemini API 키를 프로비저닝하거나 사용하지 않습니다. 이제 Firebase AI Logic는 Firebase 프로젝트에서 자동으로 프로비저닝되는 Google 관리 서비스 계정 (P4SA)을 사용하여 Gemini Developer API의 승인을 처리합니다.
Firebase AI Logic 서비스 에이전트 (service-PROJECT_ID@gcp-sa-firebasevertexai.iam.gserviceaccount.com)

이 변경사항에 따라 Gemini Developer API key (auto created by Firebase)라는 이름의 API 키를 검토하고 삭제할 수 있습니다. 이 키는 Google Cloud 콘솔에서 삭제할 수 있습니다. 키를 삭제하기 전에 다음을 검토하세요.

• 이 Gemini API 키는 Firebase AI Logic와 함께 사용하기 위한 목적으로만 Firebase에서 생성되었으므로 삭제해도 안전합니다. 하지만 이 키를 삭제하기 전에 생성형 AI 서버 SDK나 Genkit와 같이 Gemini Developer API에 대한 액세스 권한을 부여할 수 있는 다른 도구에서 키를 잘못 사용하지 않았는지 확인해야 합니다. 사용량을 확인하는 방법은 다음과 같습니다.
  1. Google Cloud 콘솔에서 Gemini Developer API 페이지로 이동한 다음 관리를 클릭합니다.
  2. 측정항목 탭의 사용자 인증 정보 드롭다운에서 Gemini Developer API key (auto created by Firebase)라는 키를 선택합니다.
  3. 표시된 그래프에 2026년 7월 초 (Firebase AI Logic가 이러한 API 키 사용을 중지한 시점) 이후 사용량이 표시되지 않으면 키를 삭제해도 됩니다.
     하지만 그래프에 사용량이 표시되면 다른 도구에서 키를 사용하고 있는 것이므로 해당 도구에서 사용 중임을 명확히 알 수 있도록 키 이름을 변경해야 합니다 (Firebase AI Logic에서는 사용하지 않음).
• (auto created by Firebase) 세그먼트가 포함된 이름의 다른 API 키는 삭제하지 않도록 합니다.

모바일 또는 웹 앱의 코드베이스에 Gemini API 키를 추가해야 하나요?

Firebase AI Logic SDK를 사용하는 경우 Gemini Developer API 사용을 승인하기 위한 Gemini API 키가 필요하지 않으며 앱의 코드베이스에 Gemini API 키를 추가해서는 안 됩니다.

'Firebase API 키'를 Gemini API 키로 사용할 수 있나요?

아니요. 'Firebase API 키'를 Gemini API 키로 사용하면 안 됩니다. Firebase API 키의 허용 목록에 Gemini Developer API를 추가하지 않는 것이 좋습니다.

Firebase API 키는 앱을 Firebase에 연결하기 위해 앱의 코드베이스에 추가하는 Firebase 구성 파일 또는 객체에 나열된 API 키입니다. Firebase 관련 API(예: Firebase AI Logic)에서만 키를 사용하는 경우 코드에 Firebase API 키를 포함해도 됩니다. Firebase API 키에 관한 중요 정보 알아보기

Google Cloud 콘솔의 API 및 서비스 > 사용자 인증 정보 패널에서 Firebase API 키는 다음과 같이 표시됩니다.

Firebase 관련 API가 작동하려면 Firebase API 키를 앱의 코드베이스에 추가해야 하고 Gemini Developer API는 API 키를 통해 승인될 수 있으므로 Firebase API 키의 API 허용 목록에 Gemini Developer API (Google Cloud 콘솔에서는 'Generative Language API'라고 함)를 추가하지 않는 것이 좋습니다. 이렇게 하면 Gemini Developer API가 악용될 수 있습니다.

Gemini API 키를 안전하게 유지하려면 어떻게 해야 하나요?