Démarrage rapide

Kloria expose une API compatible avec les formats OpenAI et Anthropic. Tu n’as rien à installer de spécifique : tes SDK et tes outils actuels fonctionnent, il suffit de changer l’adresse de l’API et la clé.

Format OpenAI

https://api.kloria.dev/v1

Format Anthropic

https://api.kloria.dev

Note

Le SDK Anthropic et Claude Code ajoutent eux-mêmes /v1/messages à l’adresse : donne-leur https://api.kloria.dev, sans /v1. Les outils au format OpenAI attendent l’adresse avec /v1.

En trois étapes

1. Connecte-toi à la console

   Kloria est en bêta sur invitation. Une fois ton invitation reçue, connecte-toi sur app.kloria.dev. C’est là que tu gères tes clés, ton solde et tes journaux.

2. Crée une clé API

   Dans la console, ouvre Clés API puis Créer une clé API. Donne-lui un nom qui dit où elle sert (claude-code-portable, script-factures…), puis copie-la.

   Les réglages utiles à la création :

   • Heure d’expiration : laisse « N’expire jamais » pour un usage personnel, mets une date pour une clé prêtée ou temporaire.
   • Quota : un plafond par clé limite la casse si elle fuit ou si un script boucle. Pour une clé que tu ne contrôles pas au quotidien, mets-en un.
   • Limites du modèle et Liste blanche IP : optionnels, pour restreindre une clé à certains modèles ou à certaines adresses.

   Une clé ressemble à sk-…. Traite-la comme un mot de passe : jamais dans un dépôt Git, jamais dans un message.

3. Fais un premier appel

   Mets ta clé dans une variable d’environnement, puis lance la requête ci-dessous. Une réponse JSON avec un champ choices signifie que tout fonctionne.

   macOS / Linux

   # read -s évite que la clé apparaisse à l'écran et dans l'historique
   read -s KLORIA_API_KEY && export KLORIA_API_KEY
   
   curl https://api.kloria.dev/v1/chat/completions \
     -H "Authorization: Bearer $KLORIA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "claude-sonnet-5",
       "messages": [{"role": "user", "content": "Dis bonjour en une phrase."}]
     }'

   Windows (PowerShell)

   # Saisie masquée, la clé ne reste pas dans l'historique
   $s = Read-Host "Clé Kloria" -AsSecureString
   $env:KLORIA_API_KEY = [System.Net.NetworkCredential]::new("", $s).Password
   
   $body = @{
     model    = "claude-sonnet-5"
     messages = @(@{ role = "user"; content = "Dis bonjour en une phrase." })
   } | ConvertTo-Json -Depth 5
   
   Invoke-RestMethod -Method Post -Uri "https://api.kloria.dev/v1/chat/completions" `
     -Headers @{ Authorization = "Bearer $env:KLORIA_API_KEY" } `
     -ContentType "application/json" -Body $body

Garder la clé d'une session à l'autre

Sur macOS ou Linux, ajoute export KLORIA_API_KEY="sk-…" à ton ~/.zshrc ou ~/.bashrc. Sous Windows, [Environment]::SetEnvironmentVariable("KLORIA_API_KEY", "sk-…", "User") la rend permanente pour ton compte (ouvre un nouveau terminal ensuite).

Et ensuite

Le nom du modèle est le seul paramètre qui change d’un modèle à l’autre. La liste complète et les tarifs sont sur la page Modèles et tarifs.

Claude Code

Codex CLI

VS Code

SDK Python