문서
빠른 시작
Kunavo는 OpenAI 와이어 프로토콜과 호환됩니다. 이미 OpenAI SDK를 사용하고 있다면 base URL만 변경하면 됩니다. 시작부터 첫 프런티어 모델 호출까지 5분이면 충분합니다.
Kunavo는 독립적인 OpenAI 호환 AI API 게이트웨이입니다. 하나의 API 키와 종량제 잔액으로 Claude, GPT, 이미지, 비디오, 오디오 모델을 이용할 수 있으며, 제공자별 계정은 필요하지 않습니다. 전체 온보딩은 네 단계입니다. 처음 세 단계는 한 번만 진행하면 됩니다. 네 번째 단계인 호출은 base_url만 바꾸면 됩니다.
1. 계정 만들기
Google 또는 이메일 매직 링크로 kunavo.com/app/login에 가입하세요. 사용량만큼 결제하는 방식이며 $10부터 충전할 수 있습니다. 잔액은 만료되지 않으며 실패한 요청에는 요금이 청구되지 않습니다.
2. API 키 만들기
대시보드에서 /app/keys를 열고 새 키를 클릭하세요. 키는 sk-kn-로 시작하며 생성 시 한 번만 표시되므로 복사해 안전하게 보관하세요.
권장 보안 수칙:
- 프로젝트 또는 환경(dev, staging, prod)마다 키를 하나씩 사용하세요.
- 보안 사고가 발생하면 또는 분기마다 키를 교체하세요.
- CI에서 스크립트로 호출하는 경우 키별 월간 지출 한도를 설정하세요.
3. 지갑 충전하기
/app/billing로 이동하여 Stripe Checkout을 통해 충전하세요. Stripe가 지원하는 모든 지역에서 카드를 제공하며, 인도를 제외한 모든 지역에서 Apple Pay, Google Pay 및 Link를 제공합니다. 국가별 현지 결제 수단도 표시됩니다(예: 미국의 ACH, 브라질의 Pix, 인도의 UPI, 대한민국의 KakaoPay, 네덜란드의 iDEAL, 폴란드의 BLIK). 전체 목록은 결제 수단 안내에서 확인할 수 있으며 PayPal과 SEPA 자동이체는 제공되지 않습니다. 충전은 $10부터 시작하며 실제 키로 모든 모델을 시험하기에 충분합니다. 잔액은 만료되지 않습니다.
- 사용량만큼 결제: 구독 없이 사용 요금이 지갑 잔액에서 실시간으로 차감됩니다.
- 대량 충전 보너스가 적용됩니다: $100 → +$10, $1,000 → +$200, $5,000 → +$1,250.
- 카드 명세서에 표시되는 가맹점명:
KUNAVO.COM* TOPUP.
4. 첫 번째 호출하기
모델 카탈로그에서 활성화된 모델을 선택하세요. 아래 예시는 연결을 확인할 수 있도록 저렴하고 빠른 claude-haiku-4-5 채팅 호출을 보여 줍니다.
Python (OpenAI SDK)
openai Python 패키지(v1+)는 별도 설정 없이 바로 사용할 수 있습니다. base_url가 Kunavo를 가리키도록 설정하기만 하면 됩니다.
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1",
)
resp = client.chat.completions.create(
model="claude-haiku-4-5",
messages=[{"role": "user", "content": "Say hi in one sentence."}],
)
print(resp.choices[0].message.content)Node.js
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: "claude-haiku-4-5",
messages: [{ role: "user", content: "Say hi in one sentence." }],
});
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": "claude-haiku-4-5",
"messages": [{"role": "user", "content": "Say hi in one sentence."}]
}'/app/usage에 표시됩니다.기타 모달리티
동일한 SDK로 이미지와 동영상도 처리할 수 있습니다. 가능한 경우 엔드포인트 이름은 OpenAI 형식을 따릅니다.
이미지 생성
이미지 모델인 Nano Banana, Nano Banana 2, Nano Banana Pro 및 GPT-Image-2 중 무엇이든 사용할 수 있습니다. 이미지 문서를 참조하세요.
img = client.images.generate(
model="nano-banana",
prompt="a tiny red origami crane on a white desk",
size="1024x1024",
)
print(img.data[0].url)스트리밍 채팅
stream=True를 설정하세요. 스트리밍은 모든 채팅 모델, 즉 Claude 및 GPT 전체 제품군에서 작동합니다. 응답은 OpenAI 표준 형식의 서버 전송 이벤트로 제공됩니다.
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Tell me a 2-line haiku about CI/CD."}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)