문서

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-kunavo-...",
    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, 헤더 규약, 키 로테이션 베스트 프랙티스.

과금

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

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 직접 계약에서의 드롭인 마이그레이션 가이드.