구글 AI 스튜디오(Google AI Studio)와 API 키, 제미나이 앱과의 차이 알아보기

🤔 채팅 화면만 쓰다가 코드로 연결하고 싶을 때

제미나이 앱에서 상담 문의 분류를 시켜 보니 결과가 괜찮아서, 이번에는 시트에 쌓이는 문의 수백 건에 자동으로 붙이고 싶어집니다. 앱에도 예약이나 연결 기능이 있지만, 직접 만든 프로그램에서 같은 분류를 반복하려면 API 연결을 검토합니다. 검색해 보면 API 키를 받으라는 안내가 나오고, 그 키를 받는 곳이 구글 AI 스튜디오입니다.

들어가 보면 제미나이에게 질문하는 화면과 앱을 만드는 화면이 함께 보여서, 제미나이 앱과 무엇이 다른지부터 알기 어렵습니다. 두 화면의 역할과 키를 받는 순서, 무료 조건을 정리합니다.

🔑 구글 AI 스튜디오의 정의

구글 AI 스튜디오(Google AI Studio)는 제미나이 모델을 시험하고 API 키를 발급받아 다른 프로그램에 연결하는 브라우저 개발 환경입니다. 구글은 이 화면을 제미나이 API로 개발을 시작하는 가장 빠른 방법으로 소개합니다.

API(Application Programming Interface)는 다른 프로그램이 모델에 요청을 보내는 통로이고, API 키는 요청에 사용 권한을 전달하고 어느 프로젝트의 사용량과 비용으로 처리할지 연결하는 비밀값입니다. 개념은 API 뜻과 동작 방식에 있습니다. AI Studio에서는 프롬프트 시험부터 프로그램 연결 준비까지 같은 서비스 안에서 진행할 수 있습니다.

⚖️ 제미나이 앱과 AI 스튜디오의 차이

Gemini 앱은 대화와 업무 기능을 제공하고 AI Studio는 모델 시험과 개발 설정을 제공합니다. 두 화면에서 선택 가능한 모델이나 도구가 모두 같지는 않습니다.

앱 사용량과 API 프로젝트의 과금은 구분합니다. Google AI 구독에는 AI Studio 한도 확대나 Google Developer Program의 Cloud 크레딧 혜택이 포함될 수 있지만, API가 무제한 무료가 되는 것은 아닙니다. 크레딧은 비용에 적용하는 잔액이며 대상과 적용 조건을 확인해야 합니다. 키 발급만으로 앱의 한도가 늘어나지도 않습니다. 앱 쪽 요금제는 제미나이 요금제와 무료 범위에 있습니다.

🧪 Playground, 모델을 시험하는 작업대

Playground가 제미나이에게 질문을 보내고 응답을 보는 화면입니다. 아래쪽 입력창에 질문을 적고 Run을 누르면 가운데에 응답이 나오고, 오른쪽 Run settings에서 모델과 시스템 지시문, 사고 수준, 도구를 바꿉니다.

시스템 지시문은 대화 전체에 적용할 기본 규칙입니다. 매번 프롬프트에 같은 규칙을 반복하는 대신 여기에 한 번 적어 둡니다.

Run settings에는 정해진 형식으로 답을 받는 구조화된 출력, 계산을 실행하는 코드 실행, 외부 기능을 요청하는 함수 호출, Google 검색과 웹 주소의 내용을 참고하는 도구 등이 있습니다. 사용할 수 있는 항목은 모델마다 다릅니다. 모든 도구를 켠다고 답이 좋아지지는 않으므로, 계산이 필요하면 코드 실행을, 최신 자료가 필요하면 검색을 고르는 식으로 작업 목적에 맞춥니다. 모델 목록에는 gemini-3.8-flash처럼 세대 번호가 붙은 ID가 그대로 나오는데, 이름 읽는 법은 제미나이 모델 라인업과 같습니다.

본문의 Playground 지시 예시를 재구성했습니다. 실제 AI 스튜디오 화면이나 분류 결과가 아닙니다.

🗝️ API 키를 받고 코드로 옮기는 순서

처음에는 Playground의 작은 시험부터 진행합니다. 프로그램 연결이 필요할 때 API 키를 확인합니다. API의 프로젝트는 권한과 사용량 및 비용을 묶어 관리하는 단위입니다.

연결을 준비할 때는 다음 순서로 확인합니다.

1. aistudio.google.com에 구글 계정으로 로그인합니다.
2. 대시보드의 Projects와 API Keys에서 대상 프로젝트와 기존 키를 확인합니다. 새 사용자는 기본 프로젝트와 키가 만들어져 있을 수 있으며, 기존 Cloud 사용자는 필요한 프로젝트를 가져옵니다.
3. 필요한 경우 해당 프로젝트에서 키를 만듭니다. 생성 권한 오류는 조직 관리자와 확인합니다.
4. 시험한 프롬프트에서 Get code를 열고 모델과 설정을 확인한 뒤 실행 환경에 옮깁니다.

받은 키는 코드에 직접 적지 않고 환경 변수로 넘깁니다. 환경 변수는 코드에 값을 직접 적는 대신 프로그램 실행 환경에서 읽게 하는 방식입니다. 저장한 설정 파일이나 로그로도 키가 노출될 수 있으므로 비밀값을 출력하지 않습니다. 개념과 설정 방법은 환경 변수 뜻과 쓰는 이유에 있습니다. Build의 새 Gemini 앱은 키를 서버 환경의 Secret으로 자동 구성합니다. Settings의 Secrets에서 확인하고 수정한 코드에도 키가 브라우저로 전달되지 않는지 검토합니다. Secret은 비밀값을 보관하는 설정입니다.

키 관리에서 지킬 것은 네 가지입니다.

• 브라우저에서 실행되는 화면 코드나 HTML 파일에 키를 넣지 않습니다
• 깃허브에 올리는 파일에 키 문자열을 적지 않습니다
• 키가 노출됐다면 그 키를 폐기하고 새 키를 발급합니다
• 앱을 공유하거나 배포하기 전에 누가 API 호출 비용을 부담하는지 확인합니다

🛠️ Build, 말로 앱을 만드는 화면

Playground 옆의 Build는 앱의 목적과 기능을 문장으로 설명하면 코드와 파일을 만들어 주는 화면입니다. 구글 문서 기준으로 기본 웹 앱은 화면을 담당하는 클라이언트와 API 호출을 처리하는 Node.js 서버로 구성되고, 필요하면 데이터베이스와 로그인, 지메일과 시트 같은 워크스페이스 연동을 붙일 수 있습니다.

처음 만들 앱은 기능을 작게 정하는 편이 낫습니다. "마케팅 대시보드"라고만 쓰면 범위가 넓어지고, "CSV를 올리면 캠페인별 비용과 클릭과 전환을 표로 보여 주는 앱"처럼 입력과 결과를 함께 적으면 고칠 곳이 줄어듭니다. 완성한 앱은 ZIP으로 내려받거나 깃허브로 내보내거나 구글의 앱 실행 서비스인 Cloud Run으로 배포할 수 있는데, 배포에는 사용량에 따른 비용이 생길 수 있어 미리 확인합니다. 만드는 순서와 검수 항목은 Google AI Studio 사용법에 있습니다.

💰 무료인지, 어디까지 무료인지

2026년 10월 3일 기준으로 화면 사용과 API 호출, 배포를 구분합니다.

• AI 스튜디오 화면: 무료로 시작할 수 있고 구독에 따른 한도 확대도 있습니다. 유료 키를 쓰는 호출과 공유 앱의 호출은 별도 확인합니다
• API 무료 등급: 개발자와 소규모 프로젝트를 위한 등급으로, 3.8 플래시를 포함한 여러 모델에 무료 등급이 있습니다. 다만 이미지 모델인 나노바나나와 영상 모델인 옴니에는 무료 등급이 없습니다
• 유료 API: 텍스트를 처리하는 단위인 토큰 수 등에 따라 청구합니다. 3.8 Flash의 Standard 입력은 100만 토큰당 0.75달러, 출력은 답을 만들기 위한 내부 추론에 사용한 사고 토큰까지 포함해 3.75달러입니다. 2026년 12월 31일까지의 가격이며 2027년 1월 1일에는 각각 1.50달러와 7.50달러로 안내돼 있습니다. 도구와 다른 처리 방식은 별도 가격을 확인합니다

첫 시험에는 가상 자료를 씁니다. 약관상 무상 서비스의 입력과 응답은 제품 개선과 사람의 검토에 사용될 수 있습니다. AI Studio는 이용 계정이 활성 결제 계정에 연결된 Cloud 프로젝트에 접근할 수 있거나 Workspace enterprise 계정이면 무료로 제공되더라도 유상 서비스의 데이터 조건을 적용합니다. API는 실제로 호출한 프로젝트의 결제 연결을 기준으로 봅니다. 유럽경제지역인 EEA와 영국, 스위스에서는 무상 서비스에도 유상 서비스의 데이터 처리 조건을 적용합니다.

유상 서비스의 입력과 응답을 제품 개선에 쓰지 않는다는 조건도 모든 기록이 즉시 삭제된다는 뜻은 아닙니다. 회사 자료는 약관과 조직 정책에 맞춰 사용합니다. AI Studio와 API는 18세 이상이며 업무 및 사업 목적의 개발을 위한 서비스입니다.

한도는 모델과 프로젝트에 따라 달라 AI Studio의 사용량 화면에서 확인합니다. RPM은 분당 요청 수, TPM은 분당 입력 토큰 수, RPD는 하루 요청 수입니다. 어느 한도든 넘으면 요청이 막힐 수 있고, 같은 프로젝트에서 키를 새로 만들어도 한도가 새로 생기지 않습니다. 일일 요청 한도의 기준 시간은 태평양 시간 자정입니다.

결제 계정을 연결하면 사용 등급이 달라지고 사용액과 경과 기간에 따라 상위 등급 조건을 충족할 수 있습니다. 처음에는 등급을 올리기보다 오류가 사용량, 권한, 모델 이름 중 무엇을 가리키는지 확인합니다. 선불 잔액과 자동 충전 설정 등 실제 결제 상태는 Billing에서 확인합니다.

⚠️ 자주 하는 실수

• 키를 화면 코드에 적습니다: 누구나 볼 수 있고 남이 그 키로 요청을 보내면 내 계정에 청구됩니다
• API 키로 앱의 한도를 늘리려 합니다: 앱과 API는 요금과 한도가 따로입니다
• 무료 화면이면 데이터 조건도 같다고 봅니다: 계정과 결제 연결에 적용된 데이터 처리 조건을 확인합니다
• 뉴스에 나온 모델 이름을 그대로 코드에 넣습니다: 모델 문서의 ID와 제공 상태를 먼저 확인합니다
• 내년 예산을 현재 가격으로 잡습니다: 선택한 모델의 예정 가격과 시행일을 확인합니다

❓ 자주 묻는 질문

구글 AI 스튜디오는 무료인가요?

무료로 시작할 수 있지만 모델과 화면의 한도가 있고 구독 혜택도 있습니다. API에도 무료 등급이 있습니다. 비용이 생기는 것은 유료 등급의 모델을 호출할 때, 공유한 앱의 사용자가 API를 호출할 때, Cloud Run에 배포해 서버 자원을 쓸 때입니다.

코딩을 몰라도 쓸 수 있나요?

Playground에서 모델을 시험하고 시스템 지시문을 바꿔 보는 데는 코드가 필요 없습니다. Build로 간단한 앱의 첫 버전을 만드는 것도 문장으로 됩니다. 다만 로그인과 결제, 개인정보, 외부 API가 들어가면 생성된 코드와 권한을 읽을 수 있어야 하므로, 그때는 기본 개념이 필요합니다.

무료 등급 한도는 하루 몇 번인가요?

모든 계정에 같은 하루 횟수가 적용되지는 않습니다. AI Studio에서 대상 프로젝트와 모델의 현재 한도를 확인합니다. 키 개수와 무료 횟수를 곱하지 않습니다.

제미나이 앱 요금제를 쓰면 API도 같이 되나요?

일부 구독에는 AI Studio 한도나 개발자 크레딧 혜택이 있습니다. 그래도 프로그램의 API 호출은 해당 프로젝트의 요금과 한도에 따라 관리합니다. 구독료에 모든 API 비용이 포함된다고 가정하지 않습니다.

가상 문의 한 문장으로 먼저 시험하기

aistudio.google.com에 로그인하고 Playground를 엽니다. 제공 지역과 나이 또는 조직 권한 때문에 열리지 않으면 해당 안내를 확인합니다. 첫 연습에서는 결제를 연결하거나 앱을 배포할 필요가 없습니다. 화면이 유료 키 선택을 요구한다면 비용을 확인하기 전에는 실행하지 않고 앞의 문의 분류 지시문을 메모장에 정리해도 됩니다.

Run settings에서 사용 가능한 텍스트 모델을 고르고 이름을 메모합니다. System Instructions에 앞의 문의 분류 규칙을 넣습니다. 검색이나 코드 실행은 이 분류에 필요하지 않으므로 켜지 않습니다.

입력창에 가상 문의 쿠폰은 어디에 입력하나요?를 넣고 Run을 누릅니다. 기대 결과는 쿠폰 문의 하나입니다. 설명이 붙으면 지시문에 “항목명 한 개만 출력합니다”를 추가하고 같은 문의를 다시 시험합니다. 다른 항목이 나오면 “쿠폰 입력 위치 질문은 쿠폰 문의입니다”라는 예를 추가하고 같은 입력으로 수정 결과를 확인합니다.

다음에는 새 채팅에 같은 지시문을 넣고 배송은 언제 오나요?를 시험합니다. 배송 문의가 나와야 합니다. 마지막으로 다시 새 채팅에 같은 지시문을 넣고 안녕하세요를 입력했을 때는 기타인지 확인합니다. 모델 이름, 지시문, 입력과 실제 결과 세 쌍을 별도 메모에 보관합니다.

한도 오류라면 반복 클릭하지 말고 대상 모델과 프로젝트의 사용량 및 회복 시점을 확인합니다. 세 문장이 맞아도 실제 문의 전체에서 정확하다는 뜻은 아니므로 여러 유형을 더 확인한 뒤 자동화 범위를 정합니다.

📋 3줄 요약

1. Google AI Studio는 모델과 프롬프트 시험, 앱 제작 및 API 연결 준비를 위한 브라우저 개발 도구입니다.

2. 가상 자료의 기대 결과와 응답을 비교해 지시문을 수정한 뒤 필요한 경우 프로젝트와 API 키를 확인합니다.

3. 구독 혜택과 API 과금을 구분하고 키의 보관 위치, 프로젝트 한도와 데이터 처리 조건을 확인합니다.

참고 자료

• AI Studio의 모델 시험과 Get code
• Build와 서버의 키 보관 및 공유
• API 키와 프로젝트 관리
• 모델별 API 가격
• 프로젝트 한도
• 결제와 잔액
• 데이터 처리와 이용 조건
• Google AI 구독 혜택
• Google AI Studio 사용법