문서

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="claude-haiku-4-5",
    messages=[{"role": "user", "content": "Hello, Kunavo"}],
)
print(resp.choices[0].message.content)

레퍼런스

주제 선택

시작하기

퀵스타트

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

연동 도구

클라이언트 53개의 설정 — Claude Code, Cline, Kilo Code, Roo Code, Codex CLI, opencode, CC Switch, SillyTavern, Janitor AI 등. 베이스 URL, 키, 모델 이름.

인증

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

Claude API 키

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

Gemini API 키

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

과금

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

사용량 API

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

에러

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

엔드포인트

채팅 완성

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

Messages API

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

이미지

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

비디오

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

음악

Suno V5 — 보컬, 가사, 스타일을 포함한 텍스트-음악 변환 비동기 작업 API.

가이드

프롬프트 캐싱

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

Ollama OpenAI API

Ollama의 로컬 OpenAI 호환 API를 호출하고, 같은 SDK로 호스팅된 Claude와 GPT도 사용할 수 있습니다.

OpenAI에서 마이그레이션

곧 공개

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