Gemini API 키 가이드

코딩 없이 Gemini API 키를 앱에서 쓰는 방법

Google AI Studio에서 Gemini API 키를 발급받고, 무료 티어와 유료 티어의 차이를 이해한 뒤, iPhone·Android·웹 채팅 앱에서 코드 없이 Gemini를 쓰는 방법을 정리했습니다.

Oriveo Team게시일 수정일 약 6분
  • 본인 키로 코딩 없이 Gemini를 쓰려면 Google AI Studio(aistudio.google.com/apikey)에서 API 키를 만들어 Oriveo 같은 BYOK(본인 API 키 사용) 채팅 앱에 붙여 넣으면 됩니다. 이후 요청은 키가 속한 Google Cloud 프로젝트에서 과금되거나 무료 티어 한도에 집계됩니다.
  • Gemini API에는 Flash 계열을 포함한 많은 모델의 무료 티어가 있지만, 무료 티어 콘텐츠는 Google이 제품 개선에 사용할 수 있고 Gemini 3.1 Pro Preview 같은 일부 모델은 유료 전용입니다.
  • 유료 티어 기준 2026년 9월 28일에 Gemini 3.8 Flash는 입력 토큰 100만 개당 $0.75, 출력 토큰 100만 개당 $3.75로, 전형적인 채팅 메시지 하나가 예상 1센트에 크게 못 미칩니다.
iPhone용 Oriveo의 대화 목록. 각 대화 오른쪽에 예상 비용이 표시됩니다.

Gemini 앱과 Gemini API는 어떻게 다른가

Google은 Gemini를 두 가지 방식으로 제공합니다. 무료 요금제와 유료 Google AI 요금제를 둔 Gemini 앱은 소비자용입니다. Gemini API는 개발자용으로, API 키를 만들면 본인 키를 받아들이는 채팅 앱을 포함한 소프트웨어가 본인 대신 Gemini 모델에 요청을 보냅니다.

API는 Google AI Studio에서 관리되며 Google Cloud 프로젝트가 그 기반입니다. Google 문서는 모든 Gemini API 키가 하나의 Google Cloud 프로젝트와 연결되고, 프로젝트에서 결제, 공동작업자, 권한이 관리된다고 안내합니다. 속도 제한도 키 단위가 아니라 프로젝트 단위로 적용됩니다. 유료 API 사용은 Cloud 결제 계정을 그 프로젝트에 연결해야 활성화되므로, 소비자용 Google AI 요금제가 API 요청을 대금으로 충당한다고 가정하지 마세요.

1단계: Gemini API 키 만들기

키를 만드는 데 1분 정도 걸리고 무료 티어에는 신용카드가 필요 없습니다. AI Studio가 처음이라면 서비스 약관에 동의한 뒤 기본 Google Cloud 프로젝트와 API 키가 자동으로 만들어집니다.

  • aistudio.google.com/apikey에 접속해 Google 계정으로 로그인합니다.
  • 요청받으면 서비스 약관에 동의합니다. 신규 사용자에게는 기본 프로젝트와 키가 자동으로 지급됩니다.
  • API 키를 만들거나 자동으로 만들어진 키를 복사하고, 어느 프로젝트에 속하는지 확인해 둡니다.
  • 키는 비밀번호 관리자 같은 안전한 곳에 보관합니다. Gemini 키는 보통 "AIza"로 시작합니다.

2단계: 무료 티어와 유료 티어 중 고르기

Gemini에서 가장 중요한 결정이 이것입니다. 두 티어는 가격보다 많은 부분에서 다르기 때문입니다. 가격 페이지는 모델마다 무료 티어가 "무료(Free of charge)"인지 "이용 불가"인지 적어 두고 있고, 각 티어에서 콘텐츠가 어떻게 취급되는지도 함께 안내합니다.

무료 티어에서는 Google의 가격 페이지에 따라 콘텐츠가 제품 개선에 사용될 수 있고, 유료 티어에서는 그렇지 않습니다. 개인적이거나 기밀인 내용을 붙여 넣을 계획이라면, 사용량이 무료 한도 안에 들더라도 결제를 연결할 이유가 됩니다.

속도 제한도 다릅니다. 결제가 연결되지 않은 프로젝트는 무료 티어입니다. 활성 결제 계정을 연결하면 Tier 1로 옮겨 가고, 그 위의 등급은 누적 지출에 따라 따라옵니다. 한도는 모델마다 다르며, Google은 한도가 AI Studio에 표시되고 등급이 바뀌면 자동으로 갱신된다고 밝힙니다.

2단계: 무료 티어와 유료 티어 중 고르기
무료 티어유료 티어(결제 연결)
토큰당 비용"무료(Free of charge)" 표시 모델은 무료공개된 토큰당 가격
모델 가용성Flash를 포함한 많은 모델. 일부 Pro 미리보기는 이용 불가표에 나온 모든 모델
콘텐츠 활용(Google 가격 페이지 기준)Google 제품 개선에 사용됨Google 제품 개선에 사용되지 않음
속도 제한프로젝트별 무료 티어 한도프로젝트별 Tier 1 이상

유료 티어에서 Gemini의 비용

표에는 2026년 9월 28일 기준 현재 모델 세 개의 Google 공개 유료 티어 가격을 200,000토큰까지 프롬프트 기준으로 적었고, 입력 2,000토큰·출력 600토큰의 전형적인 채팅 메시지에 대한 예상 비용도 함께 넣었습니다. Gemini 3.8 Flash의 날짜가 붙은 가격에 주의하세요. Google은 2026년 12월 31일까지 입력 $0.75, 출력 $3.75를, 2027년 1월 1일부터는 입력 $1.50, 출력 $7.50을 고지하고 있습니다.

Gemini 3.8 Flash의 계산은 2,000 × $0.75 / 1,000,000 + 600 × $3.75 / 1,000,000 = $0.00375로, 0.5센트 미만입니다. 대화가 길어지면 이전 차례가 입력으로 다시 전송되므로 메시지당 비용이 올라가고, 최종 금액은 Google의 청구서입니다.

유료 티어에서 Gemini의 비용
모델입력(USD / 100만 토큰)출력(USD / 100만 토큰)무료 티어전형적인 메시지 1개 예상 비용
Gemini 2.5 Flash-Lite0.100.40무료약 $0.0004
Gemini 3.8 Flash0.75(2027년 1월 1일부터 1.50)3.75(2027년 1월 1일부터 7.50)무료약 $0.004
Gemini 3.1 Pro Preview2.0012.00이용 불가약 $0.011

3단계: Oriveo에 키 연결하기

Oriveo는 본인 키로 동작하는 iPhone, Android, 웹용 멀티모델 채팅 앱입니다. Google Gemini는 공식 제공업체 15곳 중 하나이며 Direct AI Providers 아래에 표시됩니다. 아래는 앱 화면에 표시되는 이름입니다.

진행하면 Oriveo가 Google에 키로 접근할 수 있는 모델을 조회해 키를 확인하고 그 목록을 동기화합니다. Google이 거절한 키는 바로 알려 주므로 대화 전에 고칠 수 있습니다.

3단계: Oriveo에 키 연결하기
단계iPhoneAndroid웹
제공업체 목록 열기제공업체 탭제공업체 탭사이드바의 제공업체
설정 시작제공업체 추가제공업체 추가제공업체 추가
제공업체 선택Direct AI Providers 아래의 Google GeminiDirect AI Providers 아래의 Google GeminiDirect AI Providers 아래의 Google Gemini
키 붙여 넣기"Google Gemini 연결" 영역의 API 키 입력란"Google Gemini 연결" 영역의 API 키 입력란키 입력란. "Google Gemini에서 키 받기" 링크가 AI Studio로 연결됨
확인계속계속계속

4단계: 모델을 고르고 대화하기

연결되면 모델 선택기에 Gemini 모델이 나타납니다. Flash 모델은 빠르고 저렴해 대부분의 일상 대화에 충분하고, Pro 모델은 어려운 추론과 긴 분석용입니다. 키가 무료 티어라면 가격 페이지가 무료로 표시한 모델만 쓰세요. 유료 전용 모델은 결제 없이는 오류를 반환합니다.

대화 도중에 연결해 둔 다른 제공업체의 모델을 포함해 다른 모델로 바꿔도 같은 스레드에서 이어집니다. 각 메시지에는 Google 공개 가격 기준 예상 비용이 표시됩니다. 무료 티어에서는 무료 표시 모델의 실제 요금이 0원이고 제한은 속도 제한이라는 점을 기억하세요.

자주 보는 오류와 의미

Gemini 오류는 원인을 짚어 줄 만큼 구체적인 경우가 많습니다.

  • "API key not valid": 키가 불완전하게 복사되었거나, 삭제되었거나, 제한을 받았습니다. AI Studio에서 다시 복사하거나 새 키를 만드세요.
  • 속도 제한 또는 리소스 소진: 그 모델에 대해 프로젝트의 분당 또는 일일 한도에 도달했습니다. 기다리거나 모델을 바꾸거나, 결제를 연결해 한도를 올리세요.
  • 본인 등급에서 모델을 쓸 수 없음: 유료 전용 모델이 있습니다. 프로젝트에 결제를 연결하거나 무료 표시 모델을 고르세요.
  • 여러 키가 동시에 한도에 걸림: 한도는 프로젝트 단위이므로 같은 프로젝트의 키들은 함께 집계됩니다.

키를 안전하게 지키기

Gemini 키는 결제가 연결되면 돈을 쓸 수 있고, 그 전이라도 무료 사용량을 소진할 수 있습니다. Oriveo는 제공업체 키를 계정 레코드가 아니라 기기나 브라우저에 보관합니다. iPhone·Android 앱은 요청을 Google로 직접 보내고, 웹 앱은 키나 BYOK 대화 내용을 남기지 않는 실시간 중계 엔드포인트를 씁니다. Oriveo는 Google 가격에 수수료를 붙이지 않습니다.

채팅 앱에는 전용 프로젝트나 전용 키를 쓰고, 사용량은 AI Studio와 Cloud 콘솔에서 점검하며, 노출된 키는 삭제하세요.

자주 묻는 질문

Gemini API는 무료인가요?
부분적으로 그렇습니다. 많은 Gemini 모델에 속도 제한 안에서 무료인 무료 티어가 있지만, Gemini 3.1 Pro Preview 같은 일부 모델은 유료 전용입니다. Google 가격 페이지에 따르면 무료 티어 콘텐츠는 제품 개선에 사용될 수 있고 유료 티어 콘텐츠는 그렇지 않습니다.
Gemini API 키는 어디서 받나요?
aistudio.google.com/apikey의 Google AI Studio에서 받습니다. 신규 사용자는 약관 동의 후 기본 Google Cloud 프로젝트와 키를 받습니다. 모든 키는 결제와 속도 제한이 관리되는 Cloud 프로젝트에 속합니다.
Google AI Pro 구독으로 Gemini API 사용료가 충당되나요?
그렇다고 가정하지 마세요. 소비자용 Google AI 요금제는 Gemini 앱을 위한 것이고, 유료 Gemini API 사용은 키의 프로젝트에 Cloud 결제 계정을 연결해야 활성화됩니다. AI Studio에서 프로젝트의 결제 상태를 확인하세요.
본인 키로 Gemini를 쓰면 얼마가 드나요?
유료 티어 기준 2026년 9월 28일에 Gemini 3.8 Flash는 2026년 12월 31일까지 입력 토큰 100만 개당 $0.75, 출력 토큰 100만 개당 $3.75로, 전형적인 채팅 메시지 하나가 예상 약 $0.004입니다.
iPhone과 Android에서 Gemini API 키를 쓸 수 있나요?
됩니다. Oriveo에서 제공업체를 열고 제공업체 추가를 누른 뒤 Google Gemini를 고르고 키를 붙여 넣어 계속하세요. 네이티브 앱은 요청을 Google로 직접 보내고, 같은 키는 웹 앱에서도 동작합니다.

함께 읽기

본인 키로 Gemini 쓰기

iPhone, Android, 웹의 Oriveo에 Gemini 키를 연결하고, Gemini를 포함한 700+ 모델 사이를 오가며 모든 메시지의 예상 비용을 확인해 보세요.