Code by AI

Documentation

Erreurs courantes et dépannage

La plupart des requêtes en échec relèvent de cinq cas. Repérez le message affiché, appliquez la correction correspondante — dans presque tous les cas, contacter le support est inutile.

Invalid key! Your api-key is invalid or expired (401)

La requête nous est bien parvenue, mais la clé n'a pas été acceptée.

  • La clé a été copiée avec un espace au début ou à la fin — recopiez-la depuis API Keys.
  • La clé a été supprimée ou a atteint sa date d'expiration. Créez-en une nouvelle.
  • Le CLI lit une autre clé que celle que vous croyez : utilisez sa commande de vérification (claude /status, opencode auth list), ou affichez la variable d'environnement exportée.

404 page not found (ou une page HTML au lieu de JSON)

Presque toujours une URL de base terminée par /v1. Le point d'entrée s'arrête ici :

1
https://www.codebyai.net/api/agent

https://www.codebyai.net/api/agent/v1/chat/completions est transmis tel quel en amont et renvoie 404. Retirez le /v1 de l'URL de base et laissez le SDK construire le chemin.

400 sur un modèle proposé par le CLI

Chaque point d'entrée ne sert que les modèles de son protocole :

  • les routes openai-compatible servent la famille GPT (modèles Codex) ;
  • les routes anthropic-messages servent la famille Claude ;
  • les modèles Gemini passent par leur propre route, décrite sur la page Gemini.

Vérifiez l'identifiant exact du modèle sur la Model Plaza ; un identifiant inexistant en amont est rejeté au lieu d'être remplacé silencieusement.

Insufficient balance

La clé est valide, le solde est vide. Rechargez depuis la page Portefeuille — la procédure est décrite dans Rechargement et solde.

Service Unavailable in Your Region

Les requêtes provenant de régions bloquées sont refusées en périphérie. Si vous pensez qu'il s'agit d'une erreur (un VPN d'entreprise dont la sortie est dans un autre pays, par exemple), écrivez-nous en précisant l'IP publique utilisée.

Toujours bloqué ?

Envoyez le code de statut de la requête en échec, l'identifiant du modèle, ainsi que l'outil et sa version à cfjwlchangji@gmail.com. C'est généralement suffisant pour identifier la cause sans appel.