Gemini API 키 — 발급 및 OpenAI SDK로 사용하는 방법

Gemini API 키는 Google의 Gemini 모델에 대한 호출을 인증합니다. 각 요청은 Authorization 헤더에 키를 포함하며, 플랫폼은 이를 통해 사용량을 측정하고 청구합니다. Gemini API 키를 받는 방법은 두 가지입니다. Google AI Studio를 통한 직접 발급(공식 방법) 또는 Kunavo를 통한 발급입니다. Kunavo 키는 OpenAI와 호환되며 Google Cloud 프로젝트 없이 Gemini, Claude, GPT, 이미지 및 동영상 모델에 접근할 수 있습니다.

옵션 1 — Google AI Studio (공식)

앞으로 Gemini만 호출할 예정이라면 Google에서 직접 키를 받으세요:

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

Gemini만 필요한 동안에는 이 방법이 적합합니다. Claude, GPT 또는 이미지 및 동영상 모델도 사용하기 시작하면 제공업체마다 키, SDK 및 청구서를 하나씩 관리해야 합니다.

옵션 2 — Kunavo (프로덕션 권장)

Kunavo는 OpenAI 호환 API 뒤에 Gemini를 제공합니다. 하나의 sk-kn- 키로 동일한 엔드포인트에서 모든 모델에 접근할 수 있습니다. Google Cloud 프로젝트가 필요 없고, Gemini는 Google 목록 가격보다 약 70 % 저렴하며($0.09 / $0.75 100만 토큰당), 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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

동일한 패턴이 Node.js와 curl에도 적용됩니다. 모델별 요금과 자세한 예시는 Gemini API 가격 가이드에서 확인할 수 있습니다.

키를 안전하게 보관하기

• 소스 코드가 아닌 환경 변수를 사용하세요. 키를 저장소에 커밋하지 말고 환경 변수에서 읽으세요. 브라우저나 모바일 번들에 절대 노출하지 말고 항상 자체 서버를 통해 전달하세요.
• 프로젝트 또는 환경마다 키를 하나씩 사용하세요. 키 하나가 유출되어도 다른 항목을 중단하지 않고 폐기할 수 있습니다.
• 정기적으로 교체하세요. Kunavo는 여러 활성 키를 허용하므로 키 교체를 갑작스러운 중단이 아닌 원활한 중첩 방식으로 수행할 수 있습니다.
• 키별 지출 한도를 설정하세요. 대시보드에서 키별 한도를 설정하고 /app/usage에서 키별 예기치 않은 트래픽을 모니터링하세요.

자주 묻는 질문