ModelHargaDokumentasiPanduanKasus penggunaanBandingkanTentang
MasukMulai
Back to guides
API 키·June 18, 2026·7 min read

Gemini API 키 발급 방법 — Google AI Studio vs Kunavo

Gemini API 키를 얻는 길은 두 가지입니다 — Google AI Studio에서 공식 키를 받거나, Kunavo에서 모든 모델을 하나의 OpenAI 호환 키로 호출하는 방법. 두 경로를 비교하고 프로덕션에서 바로 호출을 시작하는 가장 빠른 길을 보여줍니다.

Gemini API 키는 Google의 Gemini 모델 호출을 인증하는 베어러 자격 증명입니다. 키를 얻는 방법은 두 가지입니다 — Google AI Studio에서 공식 키를 받거나, Kunavo에서 Gemini와 Claude, GPT, 이미지/비디오까지 하나의 OpenAI 호환 키로 호출하는 방법입니다(Google Cloud 프로젝트 불필요). 이 가이드는 두 경로를 비교하고, 프로덕션에서 곧바로 호출을 시작하는 가장 빠른 길을 보여줍니다.

방법 1 — Google AI Studio (공식)

Gemini만 호출할 계획이라면 Google에서 직접 키를 받는 것이 알맞습니다.

  1. aistudio.google.com에 접속해 Google 계정으로 로그인합니다.
  2. Get API key → Create API key로 키를 생성합니다. 키는 AIza... 형태입니다.
  3. 프로토타이핑용 무료 등급은 요청 제한이 있어 초기 개발에 적합합니다.
  4. 프로덕션 볼륨을 처리하려면 결제가 활성화된 Google Cloud 결제 계정에 키를 연결해야 합니다.

Gemini가 앞으로도 유일하게 호출할 모델이라면 이 경로가 맞습니다. 다만 Claude나 이미지/비디오 모델도 함께 쓴다면 제공자마다 별도의 키, SDK, 청구서를 따로 관리하게 됩니다.

방법 2 — Kunavo (프로덕션 권장)

Kunavo는 Gemini를 OpenAI 호환 엔드포인트 뒤에 둡니다. 하나의 sk-kunavo- 키로 모든 모델을 호출하고 하나의 Stripe 잔액으로 결제하므로, Google Cloud 프로젝트가 필요 없습니다. Gemini는 Google 정가보다 약 70% 저렴하며, 잔액은 만료되지 않고 최소 $5 충전부터 사용한 만큼 지불합니다.

  1. 가입 — kunavo.com에서 계정을 만듭니다.
  2. $5 충전 — 사용한 만큼 지불하며 잔액은 만료되지 않습니다.
  3. 키 생성 — /app/keys에서 키를 만듭니다. sk-kunavo-로 시작하며 한 번만 표시되므로 환경 변수에 저장하세요.
  4. 호출 — OpenAI SDK의 base_url을 https://api.kunavo.com/v1로 지정하고 Gemini 슬러그를 호출합니다.

빠른 시작

공식 OpenAI SDK를 그대로 사용합니다. base_url과 모델 이름만 바꾸면 끝입니다 — 그 외에는 변경할 것이 없습니다.

gemini_quickstart.py
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

키 안전하게 관리하기

  • 환경 변수를 사용하세요. 키를 코드에 하드코딩하지 말고 KUNAVO_API_KEY 같은 환경 변수에 보관하세요. 브라우저나 모바일 번들은 공개되므로 키는 절대 클라이언트에 노출하지 말고 항상 자체 서버를 통해 프록시하세요.
  • 정기적으로 교체하세요. Kunavo는 여러 개의 활성 키를 허용하므로, 교체를 급격한 전환이 아니라 깔끔한 겹침으로 진행할 수 있습니다. 분기마다 교체하는 것을 권장합니다.
  • 키별 지출 한도를 설정하세요. 대시보드에서 키마다 지출 한도를 지정하고 /app/usage에서 키별 사용량을 확인하면, 키가 유출되더라도 다른 키에 영향을 주지 않고 폐기할 수 있습니다.

자주 묻는 질문

Gemini API는 무료인가요?

Google AI Studio는 요청 제한이 있는 무료 등급 키를 발급하며 프로토타이핑에는 충분합니다. 프로덕션 트래픽은 유료 결제로 전환됩니다. Kunavo는 최소 $5 충전부터 사용한 만큼 지불하는 방식으로, 별도의 Google Cloud 결제 계정이 필요 없고 잔액은 만료되지 않습니다.

Google Cloud 계정 없이 Gemini API 키를 받을 수 있나요?

네. Kunavo를 사용하면 Google Cloud 프로젝트나 결제 계정 없이도 가입 후 sk-kunavo- 키 하나로 Gemini를 호출할 수 있습니다. 이 키는 OpenAI 호환 엔드포인트를 통해 Gemini는 물론 Claude, GPT, 이미지, 비디오 모델까지 함께 사용합니다.

Gemini 키와 Kunavo 키는 어떻게 다른가요?

Google 키는 Gemini만 호출하며 Google Cloud 계정으로 청구됩니다. Kunavo 키는 하나의 OpenAI 호환 API로 Gemini와 함께 Claude, GPT, 이미지, 비디오 등 모든 모델을 호출하고 Stripe로 한 번에 결제합니다. 토큰당 요율과 비용 예시는 Gemini API 가격 가이드를 참고하세요.