구글 API 키 발급 방법, 클라우드·제미나이 경로 정리

구글 API 키는 사용할 서비스에 따라 발급 화면이 다릅니다. 지도·YouTube 등 API 키를 지원하는 서비스는 Google Cloud 콘솔에서, Gemini용 키는 Google AI Studio에서 시작하면 됩니다.

먼저 연결하려는 프로그램이 어떤 서비스의 키를 요구하는지 확인해야됩니다.

키를 만들었다고 모든 구글 API가 활성화되거나 무료로 바뀌는 것은 아닙니다.

Gmail 메일 읽기나 내 Drive 파일 접근처럼 사용자 권한이 필요한 기능은 API 키만으로 끝나지 않습니다.

해당 서비스의 OAuth 등 별도 인증 절차를 따라야 합니다.

구글 클라우드 API 키 발급 방법

구글이나 네이버에서 ‘Google Cloud 콘솔’을 검색합니다. 주소가 console.cloud.google.com인 공식 사이트로 들어가 구글 계정으로 로그인합니다.

1. 화면 맨 위의 프로젝트 선택 버튼을 누르고 사용할 프로젝트를 선택합니다. 새로 시작한다면 새 프로젝트를 준비합니다.
2. 콘솔 홈의 빠른 액세스 → API 및 서비스로 들어갑니다.
3. 왼쪽의 라이브러리를 선택합니다.
4. 사용할 API 이름을 검색한 뒤 검색 결과를 누릅니다.

예를 들어 YouTube의 공개 데이터를 조회하려면 YouTube Data API v3를 찾습니다. 웹사이트에 지도를 표시하려면 Maps JavaScript API처럼 실제 사용할 기능에 맞는 API를 선택해야 합니다.

프로젝트는 API 사용량·권한·결제를 관리하는 단위입니다. 처음 프로젝트를 만드는 경우에는 공식 시작 안내의 프로젝트 선택·생성 절차를 함께 확인하세요.

1. API 상세 화면에서 사용 설정(Enable)을 누릅니다. 이미 사용 설정된 API라면 관리 화면이나 사용 중 표시를 확인합니다.
2. API 및 서비스 → 사용자 인증 정보로 이동합니다.
3. 상단의 사용자 인증 정보 만들기 → API 키를 선택합니다.
4. 생성 화면에서 필요한 정보를 입력하고, API 제한에 사용할 API를 지정한 뒤 만들기(Create)를 누릅니다.
5. API 키 생성됨(API key created) 창에서 새 키를 확인하면 발급이 완료된 것입니다.

일반 Cloud 키 안내를 따라 만들 때는 다른 용도의 서비스 계정 연결 옵션을 무조건 선택하지 않습니다. 연결할 서비스가 요구하는 인증 방식과 키 종류를 확인하세요.

API 키 확인과 제한 설정하기

발급한 키는 사용자 인증 정보 목록 → 해당 키 이름을 선택해 다시 확인할 수 있습니다. 키를 복사할 때는 앞뒤 공백이나 다른 프로젝트의 키가 섞이지 않도록 확인하세요.

일반 Cloud 키는 사용할 API와 실행 환경을 제한해 두는 것이 좋습니다. 생성 단계에서 제한을 넣었더라도 키 세부정보에서 다시 확인합니다.

• API 제한: 실제 사용할 API만 선택합니다.
• 애플리케이션 제한: 웹사이트, IP 주소, Android 앱, iOS 앱 중 사용 환경에 맞는 종류를 선택합니다.
• 허용할 주소나 앱 정보를 입력한 뒤 저장을 누릅니다.

예를 들어 웹사이트용 설정을 서버용 키에 그대로 적용하면 정상 키라도 요청이 거절될 수 있습니다. 제한 항목과 저장 방법은 공식 API 키 관리 안내에서 확인할 수 있습니다.

키 문자열을 확인한 것은 발급 성공을 뜻합니다. 원하는 API 호출까지 성공했는지는 해당 서비스의 공식 테스트 절차로 별도 확인해야 합니다.

구글 제미나이 API 키 발급 방법

Gemini를 연결하려면 ‘Google AI Studio’를 검색하거나 아래 버튼으로 들어갑니다. 공식 주소는 aistudio.google.com입니다.

처음 이용하는 계정은 서비스 약관을 확인하는 단계가 나올 수 있습니다.

기본 프로젝트와 키가 이미 준비되어 있다면 무조건 새로 만들 필요는 없습니다. 키가 연결된 프로젝트부터 확인하세요.

원하는 프로젝트가 보이지 않는 경우에는 왼쪽의 프로젝트 메뉴에서 준비합니다.

• 새로 시작하는 경우에는 새 프로젝트 만들기를 선택해 화면 안내에 따라 프로젝트를 준비합니다.
• 기존 Google Cloud 프로젝트를 쓰려면 프로젝트 가져오기 → 프로젝트 검색·선택 → 가져오기 순서로 진행합니다.

프로젝트가 준비되면 왼쪽의 API 키 → API 키 만들기를 누릅니다. 새 키 만들기 창에서는 다음 순서로 입력합니다.

1. 키 이름 지정: 용도를 알아볼 수 있는 이름을 입력합니다. 예를 들어 my-gemini-key처럼 정하면 됩니다.
2. 가져온 프로젝트 선택: 이 키를 연결할 본인의 프로젝트를 선택합니다.
3. 키 만들기를 누릅니다.

API 키 목록으로 돌아오면 방금 만든 키 이름과 연결된 프로젝트를 확인하고 키를 복사합니다. 프로젝트를 잘못 선택했다면 엉뚱한 프로젝트의 사용량이나 결제 설정을 보게 될 수 있으므로 이 단계까지 확인하세요.

Gemini용 키는 지도·YouTube용 키와 구분해서 보관하세요.

생성과 프로젝트 관리에 관한 자세한 설명은 공식 Gemini API 키 안내에서 확인할 수 있습니다.

키 전체 값을 글·댓글·공개 저장소에 올리지 마세요.

특히 Gemini 비밀 키를 공개 웹페이지 코드에 직접 넣으면 다른 사람이 가져갈 수 있으므로 서버 등 안전한 환경에서 관리해야 합니다.

FAQ

Q. API 키를 만들 때 프로젝트는 왜 필요한가요?

프로젝트는 API 사용량·권한·결제를 묶어서 관리하는 단위입니다. 웹페이지 링크를 프로젝트에 붙여 넣어 API 키로 바꾸는 과정은 아닙니다.

AI Studio에는 모든 Cloud 프로젝트가 자동으로 표시되지 않을 수 있습니다.

기존 프로젝트가 없다면 새로 준비하고, 이미 있는 프로젝트가 보이지 않으면 프로젝트 가져오기를 확인하세요.

회사나 조직의 프로젝트라면 키 생성 권한이 있는지도 관리자에게 확인해야 합니다.

Q. 구글 API 키를 만들면 무료로 사용할 수 있나요?

키 발급과 실제 API 사용 요금은 별개입니다. 무료 사용 범위가 있는 서비스라도 사용량·모델·프로젝트 결제 설정에 따라 비용이 발생할 수 있습니다.

• 지도 등 Cloud API: 사용할 API의 결제 요건과 무료 사용 범위를 확인합니다.
• Gemini API: 무료로 제공되는 모델인지, 유료 사용 단계인지, 현재 할당량이 얼마인지 확인합니다.
• API를 연결하기 전에 키가 속한 프로젝트의 결제 상태도 확인합니다.

키 생성 화면이나 완료 메시지만 보고 무료·무제한이라고 판단하지 마세요.

서비스별 요금은 Google Cloud 가격 안내와 Gemini API 가격표를 기준으로 확인하는 것이 안전합니다.