OpenClaw VPS에서 Google(Gemini) API 키가 AIzaSy로 시작하지 않아도 정상인가요?
💡 요약 정리
네, 정상입니다. 현재 Google AI Studio에서 새로 발급되는 API 키는 AQ. 로 시작하는 신형 키입니다. AIzaSy로 시작하지 않아도 잘못된 키가 아니며, 발급받은 키를 그대로 사용하시면 됩니다.
1. Google API 키 형식이 변경되었습니다
Google AI Studio(aistudio.google.com/apikey)에서 새로 발급되는 Gemini API 키는 형식이 변경되어 아래와 같이 시작합니다.
| 구분 | 키 시작 형식 | 설명 |
|---|---|---|
| 신형 키 | AQ. 로 시작 | 현재 새로 발급되는 기본 형식입니다. 정상 키입니다. |
| 기존 키 | AIza 로 시작 | 이전에 발급된 키입니다. Google 안내에 따라 2026년 9월부터는 Gemini API에서 지원이 종료될 예정입니다. |
자세한 내용은 Google 공식 안내(https://ai.google.dev/gemini-api/docs/api-key)에서 확인하실 수 있습니다.
2. 온보딩 화면에 "AIzaSy... 형식"으로 안내되는 경우
설정 화면의 형식 안내(예: "AIzaSy... 형식입니다")는 기존 키 기준의 안내입니다. 발급받은 키가 AQ. 로 시작한다면 정상 키이므로, 아래 사항을 먼저 확인해 주세요.
- 발급받은 키의 시작 형식이 AQ. 인지 확인합니다.
- 키를 복사할 때 앞뒤 공백이 함께 복사되지 않도록 다시 붙여넣어 주세요. (등록 실패의 가장 흔한 원인입니다.)
- 키는 발급 직후 한 번만 표시되는 경우가 있으므로, 보관해 둔 정확한 키 값을 사용해 주세요.
3. 그래도 등록이 되지 않는 경우
키 형식이 정상(AQ. 시작)인데도 설정 화면에서 등록이 되지 않는다면, 서비스 설정 확인이 필요할 수 있습니다. 사용 중인 서비스 정보와 함께 1:1 문의로 접수해 주시면 확인 후 안내해 드리겠습니다.
문제가 해결되지 않았나요?
위 방법으로도 해결되지 않으시면, 사용 중인 서비스 정보와 증상을 남겨 1:1 문의게시판으로 문의해 주세요. 확인 후 안내해 드리겠습니다.