Documentação

Do registo ao primeiro token — em cinco minutos.

O Kunavo segue o protocolo wire da OpenAI. Se já usa o SDK da OpenAI, migrar custa uma alteração de uma linha no base_url. A sério.

Iniciar o quickstart Ver 35 modelos

A primeira chamada

Aponte o SDK para o Kunavo.

O SDK Python da OpenAI funciona tal como está. Defina o base_url e uma chave de API obtida em /app/keys — o seu código de chat / imagem / embeddings continua a funcionar com 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 tema

Começar

Quickstart

Registe-se, carregue a carteira e faça a primeira chamada em menos de cinco minutos.

Integrações

Configuração para 51 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 cabeçalhos e boas práticas de rotação de chaves.

Claude API key

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

Gemini API key

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

Pagamentos

Como funcionam o carregamento da carteira, a fórmula de margem e o registo de créditos.

API de utilização

GET /v1/usage — consulte a contagem diária de tokens e o custo de qualquer chave de API, limitado a essa chave.

Erros

Códigos de estado HTTP, formato do payload de erro e uma estratégia de retry que não esgota o orçamento.

Endpoints

Chat completions

/v1/chat/completions compatível com OpenAI, com streaming, tools, visão e reasoning.

Messages API

Messages API nativa da Anthropic — passe cache_control, tools e thinking diretamente 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 e Lite. API para tarefas de longa duração.

Music

Suno V5 — text-to-music with vocals, lyrics and styles. Async task API.

Guias

Prompt caching

Corte 90 % do custo de entrada da Anthropic em prompts repetidos — como se articulam o cache_control, o affinity routing e as métricas do painel.

Ollama OpenAI API

Call Ollama's local OpenAI-compatible API — and point the same SDK at hosted Claude and GPT.

Migrar da OpenAI

Em breve

Guias de migração direta a partir da OpenAI, da Anthropic e da Google.