Gemini 2.5 models will shut down in October 2026. To avoid service disruptions, update to a newer model (like gemini-3.6-flash or gemini-3.1-flash-image). Any stable Gemini Live API 2.5 models are not impacted. Learn more.
Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
이 페이지에서는 Gemini API
및 Firebase AI Logic SDK의 일반적인 오류 코드 문제 해결 방법을 제공합니다.
400 오류: API key not valid. Please pass a valid API key.
API key not valid. Please pass a valid API key.라는 400 오류가 표시되면 일반적으로 Firebase 구성 파일/객체의 API 키가 없거나 앱 또는 Firebase 프로젝트와 함께 사용하도록 설정되지 않았음을 의미합니다.
Firebase 구성 파일/객체에 나열된 API 키가 앱의 API 키와 일치하는지 확인합니다. API 및 서비스 > 사용자 인증 정보
패널에서 모든 API 키를 볼 수 있습니다. Google Cloud
일치하지 않는 것으로 확인되면
새 Firebase 구성 파일/객체를 가져온 후
앱에 있는 구성 파일/객체를 바꿉니다. 새 구성 파일/객체에는
앱 및 Firebase 프로젝트의 유효한 API 키가 포함되어야 합니다.
400 오류: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
Firebase용 Cloud Storage URL로 멀티모달 요청을 전송하려고 하면 다음과 같은 400 오류가 발생할 수 있습니다.Cloud Storage for Firebase Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
이 오류는 프로젝트에서 필요한 서비스 에이전트
가 Agent Platform API가 프로젝트에서 사용 설정되었을 때 자동으로 프로비저닝되지 않은 프로젝트로 인해 발생합니다. 일부 프로젝트에서 알려진 문제이며, 현재 전역 수정 작업을 진행 중입니다.
다음은 프로젝트를 수정하고 이러한 서비스
에이전트를 올바르게 프로비저닝하여 멀티모달 요청에 Cloud Storage for Firebase URL을 포함할 수 있도록 하는 해결 방법입니다. 프로젝트의
소유자여야 하며 프로젝트에서 이 작업 집합을
한 번만 완료하면 됩니다.
gcloud CLI에 액세스하고 인증합니다.
가장 쉬운 방법은 Cloud Shell에서 실행하는 것입니다. 자세한 내용은
Google Cloud 문서를 참고하세요.
메시지가 표시되면 터미널에 표시된 안내에 따라
gcloud CLI가 Firebase 프로젝트에 대해 실행되도록 합니다.
403 오류: Requests to this API firebasevertexai.googleapis.com ... are blocked.
Requests to this API firebasevertexai.googleapis.com ... are blocked.라는 403 오류가 표시되면 일반적으로 앱의 Firebase 구성에 필요한 API를 호출하지 못하도록 하는 제한사항이 API 키에 있음을 의미합니다.
이 문제를 해결하려면
Google Cloud 콘솔에서 API 키의 제한사항을 업데이트하여 필요한 API를 포함해야 합니다. Firebase AI Logic의 경우
API 키를 사용하여 호출할 수 있는 선택된
API 목록에 Firebase AI Logic API
(firebasevertexai.googleapis.com)가 포함되어 있는지 확인해야 합니다.
애플리케이션에서 사용하도록 구성된 API 키 (예: iOS 앱의 'iOS 키')를 선택합니다.
API 키 수정 페이지에서 API 제한사항 섹션을 찾습니다.
키 제한 옵션이 선택되어 있는지 확인합니다. 선택되어 있지 않으면 키가 제한되지 않으며 오류의 원인이 아닐 가능성이 높습니다.
을 적용하는 것이 좋습니다.
선택된 API 드롭다운 메뉴에서
Firebase AI Logic API를 검색하고 선택하여 API 키를 사용하여 호출할 수 있는 선택된
API 목록에 추가합니다.
저장 을 클릭합니다.
변경사항이 적용되는 데 최대 5분이 걸릴 수 있습니다.
403 오류: PERMISSION_DENIED: The caller does not have permission.
PERMISSION_DENIED: The caller does not have permission.라는 403 오류가 표시되면 일반적으로 Firebase 구성 파일/객체의 API 키가 다른 Firebase 프로젝트에 속함을 의미합니다.
Firebase 구성 파일/객체에 나열된 API 키가 앱의 API 키와 일치하는지 확인합니다. API 및 서비스 > 사용자 인증 정보
패널에서 모든 API 키를 볼 수 있습니다. Google Cloud
일치하지 않는 것으로 확인되면
새 Firebase 구성 파일/객체를 가져온 후
앱에 있는 구성 파일/객체를 바꿉니다. 새 구성 파일/객체에는
앱 및 Firebase 프로젝트의 유효한 API 키가 포함되어야 합니다.
404 오류: Firebase AI Logic genai config not found
Firebase AI Logic genai config not found라는 404 오류가 표시되면 일반적으로 Firebase AI Logic의 설정이 잘못 구성되었거나
누락되었음을 의미합니다.
이 오류의 가장 가능성 높은 원인은 다음과 같습니다.
Gemini API 제공업체를 위한 Firebase 프로젝트를 아직 설정하지 않았습니다.
해결 방법: Firebase 콘솔에서 AI 서비스 >
AI Logic으로 이동합니다. 시작하기를 클릭한 후 선택한 Gemini API 제공업체를 선택합니다. API를 사용 설정하면 Firebase에서 해당 제공업체를 위한 프로젝트를 설정합니다. 워크플로를 완료한 후 요청을 다시 시도합니다.
Firebase AI Logic 설정 워크플로를 Firebase 콘솔에서 최근에 진행한 경우 Firebase AI Logic의 구성이 아직 모든 관련 리전의 모든 필수 백엔드 서비스에서 제공되지 않을 수 있습니다.
해결 방법:
몇 분 정도 기다린 후 요청을 다시 시도합니다.
404 오류: 모델을 "was not found or your project does not have access to it"할 수 없나요?
예: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-08-02(UTC)"],[],[]]
