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

Gemini API key는 Google의 Gemini 모델에 대한 호출을 인증하는 자격 증명입니다. 각 요청은 Authorization 헤더에 키를 포함하며 사용량은 토큰 단위로 측정되고 청구됩니다. 작동하는 키를 얻는 방법은 두 가지입니다. Gemini 전용 키를 제공하는 공식 Google AI Studio 또는 OpenAI 호환 키 하나로 Google Cloud 프로젝트 없이 Gemini, Claude, GPT 및 이미지·비디오·오디오 모델에 접근할 수 있는 Kunavo입니다. 이 안내에서는 두 방법으로 키를 얻는 방법과 첫 번째 호출을 실행하는 방법을 설명합니다.

옵션 1 — Google AI Studio (공식)

Gemini만 호출할 예정이라면 이 방법이 적합합니다.

1. Google 계정으로 aistudio.google.com에 로그인하세요.
2. Get API key → Create API key를 여세요. 키 형식은 AIza...입니다.
3. 무료 등급은 제한적이며 프로토타입에 적합합니다. 프로덕션 규모로 사용하려면 활성화된 billing 계정이 있는 Google Cloud 프로젝트에 키를 연결해야 합니다.

Claude, 이미지 또는 비디오도 사용한다면 이 방법에서는 제공업체별로 키, SDK 및 청구서를 따로 관리해야 합니다.

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

Kunavo는 OpenAI 호환 API를 통해 Gemini를 제공합니다. 키 하나 sk-kn-로 Gemini와 다른 모든 모델을 호출하고, Stripe를 통해 청구되는 하나의 지갑을 사용하며 Google Cloud 프로젝트가 전혀 필요하지 않습니다. Gemini는 Google 공식 정가보다 약 70% 저렴합니다. 예를 들어 Flash는 입력 토큰 100만 개당 $0.09, 출력 토큰 100만 개당 $0.75입니다. 최소 $10 충전부터 사용량만큼 지불하며 잔액은 절대 만료되지 않습니다.

1. kunavo.com에서 가입하세요.
2. $10 충전 — 사용량만큼 지불하며 잔액은 절대 만료되지 않습니다.
3. /app/keys에서 키를 만드세요. 키는 sk-kn-로 시작하며 한 번만 표시되므로 환경 변수에 저장하세요.
4. https://api.kunavo.com/v1을 가리키도록 OpenAI SDK를 설정하고 Gemini slug를 사용해 호출하세요.

빠른 시작

공식 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",  # satu-satunya baris yang berubah
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Jelaskan RAG dalam dua kalimat."}],
)
print(resp.choices[0].message.content)

키 보안

• 클라이언트 측에 키를 절대 노출하지 마세요. 브라우저와 모바일 번들은 공개됩니다. 항상 자체 서버를 통해 프록시하세요. 키는 버전 관리되는 코드 외부의 환경 변수에 저장하세요.
• 프로젝트 또는 환경마다 키 하나를 사용하세요. 그러면 한 키가 유출되어도 다른 키를 중단하지 않고 폐기할 수 있습니다.
• 정기적으로 키를 교체하세요. Kunavo는 여러 활성 키를 동시에 허용하므로, 키 교체를 갑작스러운 중단 없이 원활하게 진행할 수 있습니다.
• 대시보드에서 키별 지출 한도를 설정하고 /app/usage을 모니터링하여 키별로 분류된 예기치 않은 트래픽을 확인하세요.

자주 묻는 질문