Documentação

Do cadastro ao primeiro token — em cinco minutos.

O Kunavo segue o protocolo wire da OpenAI. Se você já usa o SDK da OpenAI, migrar é uma mudança de uma linha em base_url. Sério.

Iniciar quickstart Ver 35 modelos

Primeira chamada

Aponte seu SDK para o Kunavo.

O SDK Python da OpenAI funciona como está. Configure base_url e sua chave API em /app/keys, e seu código de chat/image/embedding existente continua rodando contra qualquer modelo de fronteira.

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)

Referência

Escolha um tópico

Começar

Início rápido

Do cadastro à primeira chamada de API em menos de 5 minutos.

Integrações

Configuração para 53 clientes — Claude Code, Cline, Kilo Code, Roo Code, Codex CLI, opencode, CC Switch, SillyTavern, Janitor AI e outros: base URL, chave e nome do modelo.

Autenticação

Chaves de API, base URL, convenções de headers e boas práticas de rotação de chaves.

Chave de API do Claude

Obtenha uma chave de API do Claude, chame o Claude com o SDK da OpenAI ou a Messages API nativa, e os códigos de erro de uma chave inválida.

Chave de API do Gemini

Obtenha uma chave de API do Gemini no Google AI Studio, chame-a com o SDK da OpenAI e mantenha-a fora do bundle.

Cobrança

Recarga da carteira, fórmula de markup e como funciona o livro de créditos.

API de uso

GET /v1/usage — consulte o uso diário de tokens e o custo da sua API key.

Erros

Status HTTP, formato de error payload e estratégia de retry sem queimar orçamento.

Pontos de extremidade

Conclusões de chat

/v1/chat/completions compatível com OpenAI com streaming, tools, vision, reasoning.

API de mensagens

Messages API nativa da Anthropic — passe cache_control, tools e thinking direto ao Claude.

Imagens

Texto-para-imagem e edição de imagem (i2i) — Nano Banana e GPT-Image-2.

Vídeo

Veo 3.1 — Fast, Quality, Lite. API para tarefas longas.

Música

Suno V5 — API assíncrona de tarefas para transformar texto em música com vocais, letras e estilos.

Guias

Cache de prompt

Economize 90 % dos custos de input da Anthropic em prompts repetidos — como cache_control, affinity routing e métricas do dashboard se combinam.

API OpenAI compatível do Ollama

Chame a API local compatível com OpenAI do Ollama e use o mesmo SDK com Claude e GPT hospedados.

Migrar da OpenAI

Em breve

Guia drop-in de migração da OpenAI, Anthropic e Google direto.