Gemini API Key 포맷 변경에 따른 Endpoint 호환성 이슈 및 마이그레이션 전략

Context

Google이 Gemini API Key 형식을 기존 Standard(AIza)에서 신규 Auth(AQ.) 방식으로 전환하며 인증 체계 변경을 진행함. 기존 AIza 키의 단계적 폐기 일정에 따라 구형 키를 사용하는 시스템의 가용성 저하 위험이 발생함.

Technical Solution

• 신규 Auth Key(AQ.) 도입을 통한 최신 인증 표준 적용
• Native Gemini Endpoint(generativelanguage.googleapis.com)를 통한 AQ. 키의 정상 작동 확인
• OpenAI-compatible Endpoint(/v1beta/openai) 사용 시 Authorization: Bearer 헤더와 AQ. 키 간의 인증 충돌(Multiple authentication credentials) 해결 필요
• AIza 키의 즉각적인 폐지를 방지하기 위한 'Gemini API 전용 제한(Restrict)' 설정으로 임시 가용성 확보
• Google Cloud Service Account 메트릭 대신 AI Studio 전용 관리 체계로의 모니터링 지점 이동
• SDK 내부 처리 로직을 통한 인증 포맷 추상화로 클라이언트 사이드 영향도 최소화