문서

5분이면 가입에서 첫 토큰까지.

Kunavo는 OpenAI 와이어 프로토콜을 따릅니다. 이미 OpenAI SDK를 사용 중이시라면, 마이그레이션 비용은 base_url 한 줄 변경입니다. 정말로요.

첫 번째 호출

SDK를 Kunavo로 가리키기만.

OpenAI Python SDK는 그대로 작동합니다. /app/keys에서 가져온 base_url과 API 키만 설정하면 — 기존의 chat / image / embedding 코드가 모든 프런티어 모델에서 계속 작동합니다.

first_call.py

from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

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

레퍼런스

주제 선택

시작하기

퀵스타트

가입, 지갑 충전, 첫 호출까지 5분 이내.

인증

API 키, 기본 URL, 헤더 규약, 키 로테이션 베스트 프랙티스.

Claude API key

Claude API 키 발급, OpenAI SDK 또는 네이티브 Messages API로 호출하는 방법, 잘못된 키가 반환하는 오류 코드.

Gemini API key

Google AI Studio 또는 Kunavo에서 Gemini API 키를 발급받아 OpenAI SDK로 호출하는 방법과 번들에 넣지 않는 요령.

과금

지갑 충전, 마크업 공식, 크레딧 원장의 작동 방식.

Usage API

GET /v1/usage — API 키별로 일별(또는 시간별) 토큰 사용량과 비용을 조회.

에러

HTTP 상태 코드, 에러 페이로드 형태, 예산을 낭비하지 않는 재시도 전략.

엔드포인트

Chat completions

스트리밍, 도구, 비전, 추론을 지원하는 OpenAI 호환 /v1/chat/completions.

Messages API

네이티브 Anthropic Messages API — cache_control, 도구, thinking을 Claude로 그대로 전달.

이미지

텍스트-투-이미지와 이미지 편집 (i2i) — Nano Banana와 GPT-Image-2.

비디오

Veo 3 — Fast, Quality, Lite. 장시간 실행 작업 API.

Music

Suno V5 — text-to-music with vocals, lyrics and styles. Async task API.

가이드

프롬프트 캐싱

반복 프롬프트로 Anthropic 입력 비용 90% 절감 — cache_control, 어피니티 라우팅, 대시보드 지표가 모두 어떻게 연결되는지.

Ollama OpenAI API

Call Ollama's local OpenAI-compatible API — and point the same SDK at hosted Claude, Gemini and GPT.

OpenAI에서 마이그레이션

곧 공개

OpenAI, Anthropic, Google 직접 계약에서의 드롭인 마이그레이션 가이드.