Documentazione

Dalla registrazione al primo token — in cinque minuti.

Kunavo aderisce al protocollo wire di OpenAI. Se usi già l'SDK OpenAI, migrare è un cambio di una riga in base_url. Davvero.

Inizia il quickstart Esplora 35 modelli

Prima chiamata

Punta il tuo SDK a Kunavo.

L'SDK Python OpenAI funziona così com'è. Imposta base_url e la tua API key da /app/keys, e il tuo codice chat/image/embedding esistente continua a funzionare con qualsiasi modello frontiera.

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)

Riferimento

Scegli un argomento

Per iniziare

Quickstart

Dalla registrazione alla prima chiamata API in meno di 5 minuti.

Integrazioni

Configurazione per 53 client — Claude Code, Cline, Kilo Code, Roo Code, Codex CLI, opencode, CC Switch, SillyTavern, Janitor AI e altri: base URL, chiave e nome del modello.

Autenticazione

Chiavi API, base URL, convenzioni degli header, best practice per la rotazione delle chiavi.

Chiave API Claude

Ottieni una chiave API Claude, chiama Claude con l'SDK OpenAI o la Messages API nativa, e i codici di errore di una chiave non valida.

Chiave API Gemini

Ottieni una chiave API Gemini da Google AI Studio, chiamala con l'SDK OpenAI e tienila fuori dal bundle.

Fatturazione

Ricarica del wallet, formula del markup, come funziona il libro mastro dei crediti.

API di utilizzo

GET /v1/usage — interroga il consumo giornaliero di token e il costo della tua API key.

Errori

Codici HTTP, forma dell'error payload, strategia di retry senza sprecare budget.

Endpoint

Chat completions

/v1/chat/completions compatibile con OpenAI, con streaming, tools, vision, reasoning.

Messages API

Messages API nativa Anthropic — passa cache_control, tools e thinking direttamente a Claude.

Immagini

Testo-a-immagine e modifica di immagini (i2i) — Nano Banana e GPT-Image-2.

Video

Veo 3.1 — Fast, Quality, Lite. API per task lunghi.

Musica

Suno V5: da testo a musica con voci, testi e stili. API per attività asincrone.

Guide

Prompt caching

Risparmia il 90 % dei costi di input Anthropic sui prompt ripetuti — come si combinano cache_control, affinity routing e metriche del dashboard.

API OpenAI compatibile di Ollama

Chiama l’API locale di Ollama compatibile con OpenAI e usa lo stesso SDK con Claude e GPT ospitati.

Migrare da OpenAI

Presto disponibile

Guida drop-in alla migrazione da OpenAI, Anthropic e Google diretti.