Gemini API 키를 얻는 방법 — Google AI Studio와 Kunavo의 2가지 방법

Gemini API 키는 Google의 Gemini 모델 호출을 인증하는 베어러 자격 증명입니다. 얻는 방법은 두 가지입니다. Google AI Studio(공식)에서 받거나, Kunavo의 하나의 OpenAI 호환 키로 Gemini·Claude·GPT·이미지/동영상을 모두 호출하는 방법입니다(Google Cloud 프로젝트는 필요하지 않음). 이 가이드에서는 두 절차와 프로덕션에서 어느 쪽을 선택해야 하는지 설명합니다.

방법 1 — Google AI Studio(공식)

Gemini만 사용한다면 Google에서 직접 키를 받는 것이 정석입니다.

1. aistudio.google.com에 Google 계정으로 로그인합니다.
2. API 키 받기 → API 키 만들기를 엽니다. 키는 AIza...와 같은 형식입니다.
3. 프로토타입에는 레이트 제한이 있는 무료 티어를 사용할 수 있습니다. 프로덕션 처리량에서는 결제가 활성화된 Google Cloud 프로젝트에 키를 연결해야 합니다.

호출할 모델이 Gemini뿐이라면 이것이 올바른 방법입니다. 하지만 Claude나 이미지·동영상 모델도 함께 사용한다면 프로바이더마다 별도의 키·SDK·청구서를 관리해야 합니다.

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

Kunavo는 OpenAI 호환 API 뒤에 Gemini를 배치합니다. 하나의 sk-kn- 키로 Gemini와 그 밖의 모든 모델에 연결할 수 있고 Google Cloud 프로젝트가 필요하지 않으며 결제는 Stripe의 하나의 잔액으로 통합됩니다. Gemini는 Google 정가보다 약 70% 저렴하며, $10부터 사용량 기반 과금을 시작할 수 있습니다.

1. 가입 — kunavo.com에서 계정을 만듭니다.
2. $10 충전 — 사용량 기반 과금이며 잔액은 만료되지 않습니다.
3. 키 만들기 — /app/keys에서 키를 만듭니다. sk-kn-로 시작하며 표시되는 것은 한 번뿐이므로 환경 변수에 저장합니다.
4. 호출 — OpenAI SDK의 base_url를 https://api.kunavo.com/v1로 지정하고 Gemini 슬러그를 지정합니다.

어느 방식이 더 적합한지는 Gemini API 키 문서의 비교표에서도 확인할 수 있습니다. 요금 내역은 Gemini API 요금 가이드를 참조하세요.

빠른 시작

공식 OpenAI SDK를 그대로 사용합니다. 변경할 것은 base_url와 모델 이름뿐입니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)

키 안전하게 관리하기

• 환경 변수를 사용하세요. 키를 코드에 직접 작성하지 말고 KUNAVO_API_KEY와 같은 환경 변수에서 읽으세요. 브라우저나 모바일 번들은 공개되므로 클라이언트 측에 키를 노출하지 말고 반드시 자체 서버를 통해 프록시하세요.
• 정기적으로 교체하세요. Kunavo는 여러 개의 유효한 키를 동시에 보유할 수 있으므로, 교체는 강제 전환이 아니라 원활한 겹침 방식으로 수행할 수 있습니다. 분기별 교체를 기준으로 삼으세요.
• 키별 한도를 설정하세요. 대시보드에서 키별 한도를 설정하고 프로젝트나 환경별로 키를 분리하면 키가 유출되더라도 전체를 중단하지 않고 해당 키만 폐기할 수 있습니다. /app/usage에서 키별 트래픽을 모니터링하세요.

자주 묻는 질문