Dépannage

Diagnostiquer en trente secondes

Avant de chercher du côté de ton outil, vérifie que la clé et l’API répondent, sans intermédiaire :

La clé est-elle valide ?
Fenêtre de terminal
```
curl -sS -o /dev/null -w "%{http_code}\n" https://api.kloria.dev/v1/models \
  -H "Authorization: Bearer $KLORIA_API_KEY"
```
200 : la clé est bonne, le problème est dans la configuration de l’outil. 401 : le problème vient de la clé.

Le modèle répond-il ?

curl -sS https://api.kloria.dev/v1/chat/completions \
  -H "Authorization: Bearer $KLORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 5, "messages": [{"role": "user", "content": "."}]}'

Une réponse avec choices : tout fonctionne côté Kloria. Une erreur : son message te dit pourquoi (voir ci-dessous).

La requête apparaît-elle dans la console ?

Ouvre Journaux d’utilisation. Si les requêtes de ton outil n’y sont pas, elles ne partent pas vers Kloria : vérifie l’adresse configurée.

Messages d’erreur fréquents

« Invalid token » ou « Token not provided » (401)

La clé est absente de la requête, mal copiée, désactivée ou expirée.

Vérifie qu’elle commence par sk- et qu’il n’y a ni espace ni retour à la ligne autour.
Vérifie l’en-tête : Authorization: Bearer sk-… (avec le mot Bearer et une espace), ou x-api-key: sk-… en format Anthropic.
Dans la console, sous Clés API, vérifie que la clé est active et non expirée.
La clé que tu utilises est-elle bien une clé Kloria, créée dans ta console ? Une clé d’un autre service ne fonctionne pas.

« Insufficient user quota » ou message sur le quota (403)

Ton solde est épuisé, ou la clé a atteint son propre quota. Regarde Portefeuille pour le solde, et le quota de la clé sous Clés API. Voir Crédits et facturation.

« This token has no access to model… » (403)

La clé a des limites de modèle qui n’incluent pas celui demandé. Modifie la clé, ou utilise-en une autre.

« No available channel for model X under group Y »

Le modèle demandé n’existe pas sous ce nom, ou il est momentanément indisponible.

Vérifie l’identifiant exact sur la page Modèles et tarifs : claude-sonnet-5, pas Claude Sonnet 5 ni claude-sonnet-5-0.
Avec Claude Code, ce message pour un modèle Haiku signifie que ANTHROPIC_DEFAULT_HAIKU_MODEL n’est pas défini (voir Claude Code).
Si l’identifiant est correct et que l’erreur persiste, le modèle est peut-être indisponible : réessaie dans quelques minutes, puis signale-le.

« Model … has not been priced » ou « price not configured »

Le modèle n’est pas encore ouvert sur Kloria. Utilise un modèle de la liste et signale-nous celui qui t’intéresse.

Erreur 400 qui mentionne `anthropic-beta`, `context_management` ou « Extra inputs are not permitted »

Ton outil envoie des fonctions expérimentales que le modèle n’accepte pas. Pour Claude Code, ajoute CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = 1 dans le bloc env des réglages.

Erreur 429, 500, 502 ou 503

Surcharge ou incident temporaire du côté du modèle. Réessaie avec un délai croissant. Si ça dure plus de quelques minutes, signale-le.

Problèmes de configuration

Symptôme	Cause probable
Erreur 404 sur toutes les requêtes	Adresse mal formée : `/v1` en double (`…/v1/v1/…`) ou manquant. Format OpenAI : `https://api.kloria.dev/v1`. Format Anthropic : `https://api.kloria.dev`.
Réponse HTML au lieu de JSON	L’outil appelle `app.kloria.dev` (la console) au lieu de `api.kloria.dev`.
L’outil demande de se connecter à son propre compte	La configuration de passerelle n’est pas lue. Voir la page de l’outil.
Ça marche dans un terminal, pas dans un autre	La variable d’environnement n’existe que dans le premier. Rends-la permanente (voir Démarrage rapide).
Le streaming arrive d’un bloc à la fin	Un proxy d’entreprise ou un antivirus met la réponse en tampon. Teste depuis un autre réseau.

Nous signaler un problème

Écris à contact@kloria.dev avec :

l’heure approximative de la requête et le modèle utilisé ;
le code HTTP et le message d’erreur ;
l’outil et sa version, si l’erreur vient d’un outil.