문서

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

레퍼런스

주제 선택

시작하기

퀵스타트

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

인증

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

과금

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

에러

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.

가이드

프롬프트 캐싱

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

OpenAI에서 마이그레이션

곧 공개

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