API 키와 Get Code로 내 서비스에 연결하기

실험은 AI Studio에서, 기능은 내 서비스에서

Google AI Studio에서 프롬프트를 충분히 다듬었다면 다음 단계는 API 연결입니다. AI Studio는 Gemini 모델을 실험하고 Gemini API로 이어 가는 가장 빠른 개발 환경입니다.¹ 여기서 만든 프롬프트, 모델 선택, 실행 설정을 코드로 옮기면 챗봇, 문서 요약기, 리뷰 분류기 같은 실제 서비스 기능이 됩니다.

핵심은 단순합니다. API 키로 내 앱을 인증하고, generateContent 요청으로 Gemini를 호출한 뒤, 응답을 화면이나 업무 흐름에 연결하는 것입니다.

API 키 만들고 관리하기

먼저 Google AI Studio의 API 키 페이지로 이동합니다. Google 계정으로 로그인하고 약관에 동의한 뒤, Create API key 또는 API 키 만들기를 선택합니다. 이때 새 Google Cloud 프로젝트를 만들 수도 있고, 이미 운영 중인 프로젝트를 선택할 수도 있습니다. API 키는 프로젝트 단위로 관리되므로 사용량, 할당량, 결제 설정과 연결됩니다.²

처음 배우는 단계라면 새 프로젝트에 키를 만드는 편이 깔끔합니다. 반대로 회사 서비스나 기존 앱에 붙이는 경우에는 해당 서비스가 쓰는 Google Cloud 프로젝트를 선택하는 것이 관리에 유리합니다.

키가 생성되면 즉시 복사해 안전한 곳에 보관합니다. 이후에는 API 키 목록에서 키를 다시 확인하거나 삭제할 수 있습니다. 서비스별, 환경별로 키를 나누는 습관도 중요합니다. 예를 들어 dev, staging, production 키를 분리하면 테스트 중 발생한 문제를 운영 서비스와 분리해 처리할 수 있습니다.

generateContent로 첫 호출 테스트하기

가장 빠른 확인 방법은 REST 요청입니다. 터미널에서 환경 변수에 키를 넣고 호출해 봅니다.

export GOOGLE_API_KEY="발급받은_키"

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GOOGLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "고객 리뷰를 한 문장으로 요약해줘."}]
    }]
  }'

정상 응답이 오면 이제 AI Studio 밖에서도 Gemini를 호출할 준비가 된 것입니다. Python이나 JavaScript 프로젝트에서는 Google Gen AI SDK를 설치하고 같은 프롬프트를 코드 안에서 호출하면 됩니다. 중요한 점은 모델명을 코드 여러 곳에 흩어 두지 말고, 나중에 바뀔 수 있도록 한곳에서 관리하는 것입니다.

Get Code로 프롬프트 가져오기

AI Studio의 장점은 검증한 프롬프트를 다시 손으로 옮기지 않아도 된다는 점입니다. 원하는 답변이 나오는 상태에서 Get Code를 누르면 Python, JavaScript, curl 예제 형태로 코드를 받을 수 있습니다. 이 코드는 완성된 서비스가 아니라 "작동하는 출발점"입니다.

가져온 코드는 보통 세 부분으로 나누어 정리합니다.

• 사용자 입력을 받는 부분

• Gemini API에 요청을 보내는 부분

• 응답 텍스트나 JSON을 서비스 화면에 표시하는 부분

예를 들어 웹앱이라면 브라우저에서 직접 Gemini API를 부르기보다 서버 API를 하나 만듭니다. 사용자는 /api/summary 같은 내 서버 주소로 요청하고, 서버가 Gemini API를 호출한 뒤 결과만 돌려주는 구조가 안전합니다. 이 구조를 쓰면 API 키를 숨길 수 있고, 요청 횟수 제한, 입력 검증, 오류 처리도 서버에서 관리할 수 있습니다.

API 키는 코드에 넣지 않는다

초기 테스트에서는 키를 코드에 직접 넣을 수 있지만, 이는 임시 방법일 뿐입니다. Google 공식 문서도 하드코딩은 안전하지 않으므로 일시적으로만 사용하라고 안내합니다.²

운영 코드에서는 다음 원칙을 지킵니다.

• .env 파일이나 배포 플랫폼의 환경 변수에 저장한다.

• GitHub 같은 공개 저장소에 올리지 않는다.

• 프론트엔드 JavaScript에 직접 넣지 않는다.

• 모바일 앱 패키지 안에 그대로 포함하지 않는다.

• 키 노출이 의심되면 즉시 삭제하고 새로 발급한다.

• 서비스별·환경별로 키를 분리해 피해 범위를 줄인다.

API 키는 비밀번호와 같습니다. 키가 노출되면 다른 사람이 내 프로젝트의 할당량과 비용을 사용할 수 있습니다. 특히 실제 서비스에서는 호출 로그와 사용량을 주기적으로 확인해야 합니다.

운영 전 확인할 것

무료 사용량, 요청 한도, 과금 조건, 지원 모델명은 계속 바뀔 수 있습니다. 따라서 블로그 글의 숫자를 외우기보다 Google AI for Developers의 가격, 쿼터, 모델 문서를 배포 전마다 확인하는 습관이 필요합니다.¹

또한 SDK 버전과 모델명을 명시적으로 관리하세요. "예전에 되던 코드"가 갑자기 실패하는 이유는 모델명 변경, API 버전 변경, SDK 업데이트인 경우가 많습니다. AI Studio는 실험실이고, API 키와 Get Code는 그 실험을 서비스로 옮기는 다리입니다. 이 다리를 안전하게 놓아야 프로토타입이 실제 기능이 됩니다.

참고

¹Google AI Studio | Gemini API | Google AI for Developers

²Gemini API 키 사용 - Google AI for Developers