Passer au contenu principal

​
1. Quelle URL de base API faut-il renseigner ?

Selon le protocole utilisé, les principales possibilités sont les suivantes : Remarque : si vous rencontrez une erreur 404, vérifiez si un /v1 a été ajouté en trop à la fin de l’URL. Les différents outils n’assemblent pas les chemins de la même manière.

​
2. Que faire si l’appel renvoie 401 « jeton invalide » ?

  1. Vérifiez que l’API Key a bien été créée : https://jiekou.ai/settings/key-management
  2. Vérifiez que le format de Authorization dans l’en-tête de requête est : Bearer sk_xxxxxx
  3. Si vous utilisez Claude Code, la variable d’environnement doit être définie ainsi : ANTHROPIC_AUTH_TOKEN=sk_xxxxx (il n’est pas nécessaire d’ajouter le préfixe Bearer, l’outil l’ajoute automatiquement)

​
3. Comment diagnostiquer une erreur 404 « page not found » ?

Causes fréquentes :
  • URL incorrecte : par exemple, utilisation de /v3/glm-asr avec une faute de frappe
  • Erreur de routage du modèle : par exemple, les modèles Codex doivent utiliser /v1/responses au lieu de /v1/chat/completions
  • Problème d’assemblage automatique par l’outil : certains outils (comme cc-switch) ajoutent automatiquement /chat/completions ; dans ce cas, la Base URL ne doit pas contenir ce chemin

​
4. Comment configurer Jiekou.AI dans Claude Code ?

Configurez les variables d’environnement comme suit : Windows cmd : 
set ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
set ANTHROPIC_MODEL=claude-opus-4-1-20250805
set ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
Mac/Linux bash : 
export ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
export ANTHROPIC_MODEL=claude-opus-4-1-20250805
export ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
Documentation de référence : https://docs.jiekou.ai/docs/integration/claudecode

​
5. Claude Code demande une connexion obligatoire/une vérification : comment résoudre ce problème ?

La dernière version de Claude Code peut exiger une connexion obligatoire. Solutions :
  • Utiliser l’extension Cline à la place (à rechercher dans le marketplace des extensions VSCode)
  • Ou l’utiliser avec des outils de relais comme cc-switch

​
6. Comment appeler les modèles GPT-5.1 / Codex ? Pourquoi une erreur 400 est-elle renvoyée ?

La série GPT-5.1 (y compris Codex) doit utiliser l’API Responses d’OpenAI, et non Chat Completions : 
curl "https://api.highwayapi.ai/openai/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API Key>" \
-d '{
    "model": "gpt-5.1-codex",
    "input": [...],
    "max_output_tokens": 64000
  }'

​
7. Que faire si Claude 4.5 renvoie une erreur liée à un « thinking block » ?

L’erreur indique généralement : Expected ‘thinking’ or ‘redacted_thinking’, but found ‘text’. Cela est dû au fait qu’après l’activation de la fonctionnalité Thinking dans Claude 4.5, le contexte doit contenir un format spécifique de bloc de réflexion. Recommandations :
  • Effacer l’historique de conversation et recommencer
  • Ou désactiver la fonctionnalité Thinking (si elle n’est pas nécessaire)
  • Utiliser le protocole natif Anthropic plutôt que le protocole compatible OpenAI (ce dernier peut ne pas prendre entièrement en charge Thinking)

​
8. L’API Claude renvoie une erreur « entrée trop longue » ?

Les modèles Claude ont une limite de longueur d’entrée (en général, max_tokens prend en charge jusqu’à 64000). Vérifiez :
  • La longueur du texte en entrée
  • La taille des images Base64 (il est recommandé de compresser d’abord les images trop volumineuses)
  • La longueur cumulée du contexte de l’historique de conversation
Contacter le support Si cette FAQ ne permet pas de résoudre votre problème, contactez le support technique via les moyens suivants :
  • Groupe de support technique WeCom/WeChat (recommandé, réponse la plus rapide)
  • Format des informations à fournir :
    • Description du problème + captures d’écran
    • ID du compte (UUID)
    • Trace ID (le cas échéant, généralement présent dans le message d’erreur)
    • Paramètres de requête (après masquage des informations sensibles)