AIEA에서 Gemini API 키 등록하기

이 글은 AIEA 앱의 AI 자동 채점 기능을 쓰기 위해 본인의 Gemini API 키를 발급·등록하는 방법을 단계별로 설명합니다. 개발 지식이 전혀 없어도 따라 할 수 있도록 작성했어요.

0. 먼저 알아두면 좋은 것

API 키가 왜 필요한가요? AIEA는 별도의 서버를 두지 않습니다. 채점은 여러분의 기기와 여러분의 Google 계정 사이에서만 일어나요. 그래서 본인 명의의 Gemini API 키가 필요합니다.
돈이 드나요? Google AI Studio의 Gemini API는 무료 사용 한도가 넉넉합니다. 개인이 OPIc 연습용으로 쓰는 정도라면 요금이 발생하지 않는 무료 등급으로 충분해요. (정책은 Google 사정에 따라 바뀔 수 있으니 발급 화면의 안내를 확인하세요.)
키는 안전한가요? 등록한 키는 여러분의 휴대폰에만 암호화되어 저장됩니다. AIEA 개발자에게도, 다른 어떤 서버에도 전송되지 않아요. 오직 Google의 Gemini API를 호출할 때만 사용됩니다.
준비물: Google 계정(Gmail 계정) 하나면 됩니다.

웹브라우저(또는 AIEA 앱의 ‘Google AI Studio 열기’ 버튼)로 아래 주소에 접속합니다.

https://aistudio.google.com/apikey

💡 앱에서는 설정 → AI 채점 → ‘API 키 발급 방법 보기’ → ‘Google AI Studio 열기’ 를 누르면 이 페이지로 바로 이동합니다.

처음 접속하면 로그인 화면이 나옵니다. 평소 쓰는 Google(Gmail) 계정으로 로그인하세요. 약관 동의 화면이 나오면 내용을 확인하고 동의합니다.

API 키 페이지에서 파란색 Create API key(API 키 만들기) 버튼을 누릅니다.

처음이라면 새 프로젝트를 만들라는 안내가 나옵니다. ‘Create API key in new project’(새 프로젝트에서 API 키 만들기)를 선택하면 자동으로 만들어집니다.
이미 Google Cloud 프로젝트가 있다면 그중 하나를 골라도 됩니다.

잠깐 기다리면 키가 생성됩니다.

생성된 키는 AIza... 로 시작하는 긴 문자열입니다. 옆의 복사(Copy) 아이콘을 눌러 복사하세요.

⚠️ 이 키는 비밀번호와 같습니다. 다른 사람에게 보여주거나 공개된 곳(블로그, 깃허브 등)에 올리지 마세요. 노출되면 AI Studio에서 해당 키를 삭제하고 새로 발급하면 됩니다.

검증에 성공하면 “키가 저장되었습니다. AI 자동 채점이 켜졌어요.” 라는 메시지가 뜨고, 이제부터 답변을 녹음하면 앱이 직접 채점 결과를 보여줍니다. 🎉

Q. '키 검증에 실패했습니다’라고 나와요.

Q. 요금이 청구될까 봐 걱정돼요. 무료 등급 한도 안에서 쓰면 비용이 발생하지 않습니다. 걱정된다면 Google Cloud 콘솔에서 결제 수단을 등록하지 않는 것만으로도 무료 한도를 넘어 과금되는 일을 막을 수 있어요.

Q. 키를 바꾸거나 지우고 싶어요. AIEA 설정에서 ‘키 삭제’ 를 누르면 기기에서 키가 지워지고 수동 채점 모드로 돌아갑니다. 새 키를 다시 등록할 수도 있어요.

Q. API 키 없이도 쓸 수 있나요? 네. 키를 등록하지 않으면 수동 모드로 동작합니다. 앱이 채점용 프롬프트를 클립보드에 복사해 주면, 그걸 ChatGPT·Gemini·Claude 같은 챗봇에 붙여넣고 받은 답변을 다시 앱에 붙여넣으면 됩니다.

이 가이드대로 따라 했는데도 막히는 부분이 있다면 댓글로 남겨주세요. 더 자세히 도와드릴게요!