Démarrage rapide

Kunavo est une passerelle indépendante d’API IA compatible avec OpenAI : une seule clé API et un solde à l’usage vous donnent accès à Claude, GPT ainsi qu’à des modèles d’image, de vidéo et d’audio, sans compte par fournisseur. La configuration initiale se déroule en quatre étapes. Les trois premières ne sont à effectuer qu’une seule fois. La quatrième — effectuer un appel — consiste simplement à remplacer base_url.

1. Créer un compte

Inscrivez-vous sur kunavo.com/app/login avec Google ou via un lien magique envoyé par e-mail. Le paiement se fait à l’usage et commence par un rechargement de 10 $ — votre solde n’expire jamais et les requêtes ayant échoué ne sont jamais facturées.

2. Créer une clé API

Ouvrez /app/keys dans le tableau de bord, puis cliquez sur Nouvelle clé. Les clés commencent par sk-kn- et ne sont affichées qu’une seule fois, lors de leur création : copiez-les et conservez-les en lieu sûr.

Bonnes pratiques recommandées :

• Utilisez une clé par projet et par environnement (dev, staging, prod).
• Renouvelez les clés en cas d’incident ou tous les trimestres.
• Définissez un plafond de dépenses mensuelles par clé si vous effectuez des appels depuis des scripts CI.

3. Approvisionner votre portefeuille

Accédez à /app/billing et rechargez via Stripe Checkout. Les cartes sont proposées partout où Stripe est disponible, et Apple Pay, Google Pay et Link partout sauf en Inde ; des moyens locaux apparaissent selon le pays — par exemple ACH aux États-Unis, Pix au Brésil, UPI en Inde, KakaoPay en Corée du Sud, iDEAL aux Pays-Bas, BLIK en Pologne (la liste complète se trouve dans la référence de facturation ; PayPal et le prélèvement automatique SEPA ne sont pas proposés). Les rechargements commencent à $10 — suffisamment pour essayer chaque modèle avec une vraie clé — et le solde n’expire jamais.

• Paiement à l’usage : le coût de votre utilisation est déduit en temps réel de votre portefeuille, sans abonnement.
• Des bonus de volume s’appliquent : $100 → +$10, $1,000 → +$200, $5,000 → +$1,250.
• Libellé sur le relevé de votre carte : KUNAVO.COM* TOPUP.

4. Effectuer votre premier appel

Choisissez n’importe quel modèle activé dans le catalogue. Ci-dessous : un appel de chat claude-haiku-4-5 économique et rapide pour vérifier la configuration.

Python (SDK OpenAI)

Le package Python openai (v1+) fonctionne immédiatement : il suffit de diriger base_url vers Kunavo.

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

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."}]
  }'

Autres modalités

Le même SDK prend en charge les images et la vidéo. Dans la mesure du possible, les points de terminaison portent les noms d’OpenAI.

Génération d’images

Utilisez n’importe lequel des modèles d’image : Nano Banana, Nano Banana 2, Nano Banana Pro et GPT-Image-2. Consultez la documentation sur les images.

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

Chat en continu

Définissez stream=True. Le streaming fonctionne avec tous les modèles de chat — les familles Claude et GPT complètes. La réponse est transmise sous forme d’événements envoyés par le serveur, au format standard d’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)

Étapes suivantes

1. Authentification — référence complète des clés API et de l’URL de base.
2. Complétions de chat — paramètres, streaming, appels d’outils et vision.
3. Facturation — fonctionnement de la formule de majoration et du registre des crédits.
4. Erreurs — codes HTTP et stratégie de nouvelle tentative.