Docs

Five minutes from signup to first token.

Kunavo follows the OpenAI wire protocol. If you're already using the OpenAI SDK, your migration cost is one base_url change. Really.

Start the quickstart Browse 19 models

Your first call

Point the SDK at Kunavo.

The OpenAI Python SDK works as-is. Set base_url and an API key from /app/keys — your existing chat / image / embedding code keeps working with any frontier model.

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)

Reference

Pick a topic

Getting started

Quickstart

Authentication

API keys, base URL, header conventions, and key rotation best practices.

Billing

How wallet top-up, the markup formula, and the credit ledger work.

Errors

HTTP status codes, error payload shape, and a retry strategy that won't burn budget.

Endpoints

Chat completions

OpenAI-compatible /v1/chat/completions with streaming, tools, vision and reasoning.

Messages API

Native Anthropic Messages API — pass cache_control, tools and thinking straight through to Claude.

Images

Text-to-image and image-edit (i2i) — Nano Banana and GPT-Image-2.

Video

Veo 3 — Fast, Quality and Lite. Long-running task API.

Guides

Prompt caching

Cut Anthropic input cost by 90% on repeat prompts — how cache_control, affinity routing, and dashboard metrics all wire together.

Migrating from OpenAI

soon

Drop-in migration guides from OpenAI, Anthropic, Google direct.