Google Gemini API 키 만들기 — 두 가지 방법(Google AI Studio 및 Kunavo)

Gemini API 키는 Google의 Gemini 모델에 대한 호출을 인증합니다. 각 요청은 Authorization 헤더에 키를 포함하며 플랫폼은 이를 통해 사용량을 측정하고 청구합니다. Gemini API 키를 만드는 방법은 두 가지입니다. Google AI Studio를 통한 공식 방법 또는 Kunavo를 통한 방법입니다. Kunavo의 OpenAI 호환 키는 Google Cloud 프로젝트 없이 Gemini와 Claude, GPT, 이미지 및 비디오 모델에 액세스할 수 있습니다.

옵션 1 — Google AI Studio API 키 만들기(공식)

Gemini만 호출할 예정이라면 Google에서 직접 키를 발급받으세요.

1. aistudio.google.com을 열고 Google 계정으로 로그인하세요.
2. Get API key → Create API key를 여세요. 키는 AIza…로 시작하며 한 번만 표시됩니다.
3. 무료 티어는 속도 제한이 있으며 프로토타이핑에 적합합니다. 프로덕션에서는 키를 Google Cloud 결제 계정에 연결하세요.

Gemini만 필요하다면 이 방법이 적합합니다. Claude, GPT, 이미지 또는 비디오 모델도 사용하려면 제공업체별로 별도의 키, SDK, 청구서를 관리해야 합니다.

옵션 2 — Kunavo를 통해 Gemini API 키 만들기(프로덕션 권장)

Kunavo는 OpenAI 호환 API 뒤에서 Gemini를 제공합니다. 하나의 sk-kn- 키로 동일한 엔드포인트를 통해 모든 모델에 액세스할 수 있습니다. Google Cloud 프로젝트가 필요하지 않고, Gemini는 Google 목록 가격보다 약 70% 저렴합니다($0.09 / 토큰 1M개당 $0.75). 하나의 Stripe 잔액으로 최소 $10 충전부터 종량제로 사용할 수 있습니다. 잔액은 Gemini, Claude, GPT, 이미지 및 비디오에 함께 적용되며 만료되지 않습니다.

1. 가입. kunavo.com에서 Kunavo 계정을 만드세요.
2. $10 충전. 최소 $10 충전부터 종량제로 사용할 수 있으며 잔액은 만료되지 않습니다.
3. 키 생성. /app/keys에서 키를 생성하세요. 키는 sk-kn-로 시작하며 한 번만 표시됩니다. 환경 변수에 저장하세요.
4. 호출. OpenAI SDK가 https://api.kunavo.com/v1를 사용하도록 설정하고 Gemini 슬러그를 호출하세요.

빠른 시작

공식 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",  # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Fasse die Handlung von Dune in zwei Sätzen zusammen."}],
)
print(resp.choices[0].message.content)

Node.js와 curl에도 같은 패턴이 적용됩니다. 모델별 요율과 계산 예시는 Gemini API 가격 가이드에서 확인할 수 있습니다.

키 안전하게 보관하기

• 소스 코드 대신 환경 변수. 키를 저장소에 절대 넣지 말고 환경 변수에서 읽으세요. 브라우저 또는 모바일 번들에 노출하지 말고 항상 자체 서버를 통해 프록시하세요.
• 프로젝트 또는 환경별 키 하나. 이렇게 하면 다른 모든 항목을 중단하지 않고 유출된 키만 폐기할 수 있습니다.
• 정기적으로 교체. Kunavo에서는 여러 활성 키를 허용하므로 키 교체를 중단 없이 깔끔하게 겹쳐 진행할 수 있습니다.
• 키별 출력 한도. 대시보드에서 키별 한도를 설정하고 /app/usage에서 키별 예상치 못한 트래픽을 확인하세요.

자주 묻는 질문