Dokumentation

Schnellstart

Kunavo ist mit dem OpenAI-Wire-Protokoll kompatibel. Wenn Sie bereits das OpenAI-SDK verwenden, müssen Sie nur die Basis-URL ändern. In fünf Minuten vom Einstieg bis zu Ihrem ersten Aufruf eines Frontier-Modells.

Kunavo ist ein unabhängiges, OpenAI-kompatibles KI-API-Gateway, über das Sie mit einem API-Schlüssel und einem nutzungsabhängig abgerechneten Guthaben Claude-, GPT- sowie Bild-, Video- und Audiomodelle erreichen, ohne für jeden Anbieter ein eigenes Konto zu benötigen. Die gesamte Einrichtung umfasst vier Schritte. Die ersten drei sind einmalig. Der vierte – einen Aufruf tätigen – ist lediglich ein base_url-Austausch.

1. Konto erstellen

Registrieren Sie sich unter kunavo.com/app/login mit Google oder per E-Mail-Magic-Link. Die Abrechnung erfolgt nutzungsbasiert und beginnt mit einer Aufladung von 10 $. Ihr Guthaben verfällt nie, und fehlgeschlagene Anfragen werden nie berechnet.

2. API-Schlüssel erstellen

Öffnen Sie /app/keys im Dashboard und klicken Sie auf Neuen Schlüssel erstellen. Schlüssel beginnen mit sk-kn- und werden beim Erstellen nur einmal angezeigt – kopieren Sie sie und bewahren Sie sie sicher auf.

Empfohlene Sicherheitsmaßnahmen:

Verwenden Sie einen Schlüssel pro Projekt bzw. Umgebung (dev, staging, prod).
Ersetzen Sie Schlüssel nach einem Sicherheitsvorfall oder vierteljährlich.
Legen Sie ein monatliches Ausgabenlimit pro Schlüssel fest, wenn Sie Aufrufe per Skript aus CI tätigen.

Behandeln Sie API-Schlüssel wie Passwörter. Speichern Sie sie niemals in Git und integrieren Sie sie nicht in clientseitige Bundles. Verwenden Sie Umgebungsvariablen und einen Secret Store.

3. Wallet aufladen

Gehen Sie zu /app/billing und laden Sie über Stripe Checkout auf. Karten werden überall angeboten, wo Stripe verfügbar ist, Apple Pay, Google Pay und Link überall außer in Indien; lokale Methoden erscheinen je nach Land — zum Beispiel ACH in den USA, Pix in Brasilien, UPI in Indien, KakaoPay in Südkorea und iDEAL in den Niederlanden, BLIK in Polen (die vollständige Liste finden Sie in der Abrechnungsreferenz; PayPal und SEPA-Lastschrift werden nicht angeboten). Aufladungen beginnen bei $10 — genug, um jedes Modell mit einem echten Schlüssel auszuprobieren — und das Guthaben verfällt nicht.

Nutzungsbasierte Abrechnung: Die Nutzung wird in Echtzeit von Ihrem Wallet-Guthaben abgezogen; es gibt kein Abonnement.
Mengenboni gelten: $100 → +$10, $1.000 → +$200, $5.000 → +$1.250.
Abrechnungsbeschreibung auf Ihrer Karte: KUNAVO.COM* TOPUP.

4. Ersten Aufruf tätigen

Wählen Sie ein beliebiges aktiviertes Modell aus dem Katalog. Unten sehen Sie einen günstigen, schnellen claude-haiku-4-5-Chat-Aufruf, mit dem Sie die Verbindung überprüfen können.

Python (OpenAI-SDK)

Das Python-Paket openai (v1+) funktioniert sofort – richten Sie einfach base_url auf Kunavo aus.

first_call.py

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

resp = client.chat.completions.create(
    model="claude-haiku-4-5",
    messages=[{"role": "user", "content": "Say hi in one sentence."}],
)
print(resp.choices[0].message.content)

Node.js

first_call.mjs

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-haiku-4-5",
  messages: [{ role: "user", content: "Say hi in one sentence." }],
});
console.log(resp.choices[0].message.content);

curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [{"role": "user", "content": "Say hi in one sentence."}]
  }'

Wenn Sie eine Antwort erhalten haben – Glückwunsch, Ihr Konto ist aktiv. Die Kosten werden innerhalb weniger Sekunden unter /app/usage angezeigt.

Weitere Modalitäten

Dasselbe SDK unterstützt Bilder und Videos. Die Endpunkte folgen nach Möglichkeit der OpenAI-Benennung.

Bildgenerierung

Verwenden Sie eines der Bildmodelle – Nano Banana, Nano Banana 2, Nano Banana Pro und GPT-Image-2. Siehe Bilddokumentation.

img = client.images.generate(
    model="nano-banana",
    prompt="a tiny red origami crane on a white desk",
    size="1024x1024",
)
print(img.data[0].url)

Streaming-Chat

Setzen Sie stream=True. Streaming funktioniert mit jedem Chat-Modell – der gesamten Claude- und GPT-Familie. Die Antwort besteht aus Server-Sent Events im Standardformat von OpenAI.

stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Tell me a 2-line haiku about CI/CD."}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Nächste Schritte

Authentifizierung – vollständige Referenz zu API-Schlüssel und Basis-URL.
Chat-Vervollständigungen – Parameter, Streaming, Tool-Aufrufe und Vision.
Abrechnung – Erläuterung der Aufschlagsformel und des Guthabenkontos.
Fehler – HTTP-Codes und Wiederholungsstrategie.