Gemini API 키

Gemini API 키는 Google Gemini 모델에 대한 요청을 인증하는 자격 증명입니다. Google AI Studio에서 직접 발급받거나, 이미 다른 모든 작업에 사용하는 OpenAI 호환 API를 통해 Gemini에 연결되는 sk-kn- 키 하나를 사용할 수 있습니다.

Gemini API 키란

Gemini API 키는 Google Gemini 모델에 대한 요청을 승인하는 bearer 자격 증명입니다. 모든 요청은 Authorization 헤더에 키를 포함하며, 플랫폼은 키를 기준으로 사용량을 측정하고 토큰별로 요금을 청구합니다. 현재 Kunavo에서는 gemini-3-1-pro 및 gemini-2-5-flash를 OpenAI 호환 엔드포인트를 통해 호출합니다.

사용 가능한 키를 발급받는 방법은 두 가지입니다. Gemini만 사용할지, 다른 최첨단 모델과 함께 사용할지에 따라 선택하세요.

방법 A — Google AI Studio에서 직접 키 발급

1. aistudio.google.com로 이동해 Google 계정으로 로그인하세요.
2. Get API key → Create API key를 여세요. 키는 AIza... 형식입니다.
3. 프로덕션 규모로 사용하려면 결제가 활성화된 Google Cloud 프로젝트에 키를 연결하세요.

앞으로 Gemini만 호출할 예정이라면 이 방법이 적합합니다. Claude, 이미지 또는 동영상 모델도 사용한다면 제공업체마다 별도의 키, SDK, 청구서를 관리해야 합니다.

방법 B — Gemini와 다른 모든 모델에 Kunavo 키 하나 사용

Kunavo는 독립적인 OpenAI 호환 AI API 게이트웨이입니다. 하나의 API 키와 종량제 잔액으로 Claude, GPT, 이미지, 비디오, 오디오 모델을 이용할 수 있으며, 제공자별 계정은 필요하지 않습니다.

Kunavo는 OpenAI 호환 API를 통해 Gemini를 제공합니다. sk-kn- 키 하나로 Gemini와 다른 모든 모델에 연결하고, Stripe로 결제되는 단일 잔액을 사용합니다.

1. Kunavo 계정을 만들고 $10를 충전하세요. 사용한 만큼 결제되며 잔액은 만료되지 않습니다.
2. /app/keys에서 키를 생성하세요. 키는 한 번만 표시되므로 환경 변수에 저장하세요.
3. OpenAI SDK가 https://api.kunavo.com/v1를 사용하도록 설정하고 Gemini 슬러그를 호출하세요.

Python에서 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",  # the only line that changes
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)

Node.js에서 Gemini 호출

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gemini-2-5-flash",
  messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);

또는 curl로 호출

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2-5-flash",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

사용할 Gemini 모델

• gemini-2-5-flash — 채팅, 정보 추출, 요약에 적합한 빠르고 매우 저렴한 기본 모델입니다.
• gemini-3-1-pro — 더 강력한 추론, 비전, 긴 컨텍스트 분석을 지원합니다.

보안 점검 목록

• 키를 클라이언트 측에 절대 노출하지 마세요. 브라우저 및 모바일 번들은 공개되므로 항상 자체 서버를 통해 요청을 전달하세요.
• 프로젝트나 환경마다 키를 하나씩 사용하세요. 키가 유출되어도 나머지 환경에 영향을 주지 않고 해당 키만 취소할 수 있습니다.
• 분기마다 키를 교체하세요. Kunavo에서는 여러 키를 동시에 사용할 수 있으므로, 기존 키를 갑자기 끊지 않고 새 키와 겹쳐 운영하며 교체할 수 있습니다.
• 예상치 못한 트래픽을 키별로 확인하려면 /app/usage을 살펴보세요.

자주 묻는 질문

다음 단계

• 빠른 시작 — 60초 만에 첫 요청 보내기
• Gemini API 가격 2026
• 전체 모델 카탈로그 둘러보기