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 27 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-kunavo-...",
    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.

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.