Gemini API 키 받기 — Google AI Studio와 Kunavo를 이용한 단계별 안내

Gemini API 키는 Google의 Gemini 모델에 대한 호출을 인증하는 bearer 자격 증명입니다. 키를 받는 방법은 두 가지입니다. 직접 Google AI Studio에서 받는 공식 방법과, Google Cloud 프로젝트를 설정하지 않고 Gemini, Claude, GPT 및 이미지/동영상에 하나의 OpenAI 호환 키를 사용하는 Kunavo를 이용하는 방법입니다. 이 가이드는 두 방법을 단계별로 보여 주며 몇 분 안에 Gemini를 호출할 수 있도록 합니다.

옵션 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는 OpenAI 호환 API 뒤에서 Gemini를 제공합니다. 하나의 sk-kn- 키로 Gemini와 다른 모든 모델(OpenAI 호환 엔드포인트를 통해)에 접근할 수 있으며 Google Cloud 프로젝트는 필요 없습니다. Gemini는 Google 목록 가격보다 약 70% 낮은 가격으로 제공되고, 하나의 Stripe 잔액으로 모든 서비스를 이용하며, $10부터 종량제로 시작합니다.

1. Kunavo 계정을 만들고 $10을 충전하세요. 종량제이며 잔액은 절대 만료되지 않습니다.
2. /app/keys 페이지에서 키를 생성하세요. 키는 한 번만 표시되므로 환경 변수에 저장하세요.
3. OpenAI SDK가 https://api.kunavo.com/v1를 가리키도록 설정하고 Gemini slug을 호출하세요.
4. 호출하세요. 모델 필드에 gemini-2-5-flash와 같은 값을 보내면 됩니다.

빠른 시작

공식 OpenAI SDK를 그대로 사용합니다. base_url와 모델 이름만 변경하고 다른 것은 변경하지 마세요.

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

키를 안전하게 보관하세요

• 키를 클라이언트 측에 절대 노출하지 마세요. 브라우저와 모바일 번들은 공개됩니다. 항상 자체 서버를 통해 프록시하세요. 키는 .env 파일과 환경 변수에 보관하고 소스 코드에 직접 삽입하지 마세요.
• 프로젝트 또는 환경마다 별도의 키를 사용하세요. 그러면 유출이 발생해도 다른 모든 것을 중단하지 않고 해당 키만 취소할 수 있습니다.
• 정기적으로 키를 교체하세요. Kunavo는 여러 활성 키를 동시에 허용하므로, 키 교체가 갑작스러운 중단이 아니라 원활한 전환 중첩이 됩니다.
• 키별 지출 한도를 설정하세요. 대시보드에서 각 키의 한도를 설정하고 /app/usage 페이지에서 예상치 못한 트래픽을 키별로 모니터링하세요.

FAQ