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 39 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="gemini-2-5-flash",
    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.

Autenticazione

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

Claude API key

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.

Gemini API key

Ottieni una chiave API Gemini da Google AI Studio o Kunavo, 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 — Fast, Quality, Lite. API per task lunghi.

Music

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

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.

Ollama OpenAI API

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

Migrare da OpenAI

Presto disponibile

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