Un problème ? Commencez ici
Localisez d’abord la destination selon le symptôme, puis déroulez ci-dessous le tableau des problèmes fréquents pour le dépannage. Pas de contenu redondant : on vous oriente seulement vers la page de référence.
Codes d’erreur complets, structure des réponses et stratégie de réessai —— 401 / 402 / 404 / 429 / 5xx en un coup d’œil.
Inscription, perte de clé API, diagnostic d’une clé invalide, questions courantes sur les modèles et les appels en streaming.
Quota gratuit, plans d’abonnement, règles de débit des 鹿贝, et que faire une fois le quota épuisé.
Intégration et dépannage des clients tiers comme Cherry Studio / Lobe Chat / OpenCat, etc.
Plateforme, MemX, Lucrum, etc. disposent chacun d’une FAQ dédiée : consultez d’abord la page des questions courantes de la documentation du produit concerné.
Dépannage par message d’erreur
Déroulez l’erreur que vous rencontrez et suivez la liste de vérification. Pour les codes d’erreur détaillés, voir Gestion des erreurs.
Retourne 401 Unauthorized / invalid_api_key
{ "error": { "code": "invalid_api_key", "type": "authentication_error" } }authentication_error indique que la clé est invalide ou absente. Vérifiez point par point :
- La clé est complète, commence par
sk-, sans espace ni saut de ligne superflu (recopiez-la une fois) - Le format de l’en-tête est
Authorization: Bearer sk-xxxx(un espace aprèsBearer) - L’état de la clé est « activé » (console → gestion des jetons)
- Le nom de la variable d’environnement est correctement orthographié et bien chargé
Ne réessayez pas un 401 : corrigez la clé puis renvoyez la requête. Voir Authentification et Questions courantes : comment diagnostiquer une clé invalide.
Retourne "no available server" / model_not_found (HTTP 404)
{ "error": { "code": "model_not_found", "message": "模型 xxx 无可用渠道", "type": "new_api_error" } }- Vérifiez l’orthographe du nom de
model(sensible à la casse) - Confirmez que cette clé a le droit d’accéder à ce modèle
- Ce modèle peut temporairement n’avoir aucun canal disponible
- Si vous venez de créer la clé, patientez environ 10 secondes puis réessayez
Pour la liste des modèles disponibles, voir Modèles pris en charge.
Retourne 429 Too Many Requests / rate_limit_exceeded
{ "error": { "code": "rate_limit_exceeded", "type": "rate_limit_error" } }Limite de débit dépassée. Comment procéder :
- Réduisez la fréquence des requêtes, réessayez après un backoff exponentiel de
2 ** attemptsecondes - Le plan Free est limité par défaut à 60 RPM ; passez à Pro / Team pour relever la limite
- Si cela se déclenche encore fréquemment après paiement, contactez support@lurus.cn
Pour un exemple de code de réessai, voir Gestion des erreurs · Bonnes pratiques.
Retourne 402 / insufficient_quota (quota / solde insuffisant)
{ "error": { "code": "insufficient_quota", "type": "billing_error" } }- Vérifiez d’abord si le quota gratuit du jour est épuisé (plan Free : 100 appels/jour)
- Consultez le solde de 鹿贝 : identity.lurus.cn/wallet
- Rechargez en libre-service ou montez de plan ; pour les règles, voir Facturation
context_length_exceeded (dépassement de contexte)
{ "error": { "code": "context_length_exceeded", "type": "invalid_request_error" } }Par exemple deepseek-chat 64K, gemini-3-pro-preview 1M : lorsque vous dépassez la limite du modèle :
- Réduisez l’entrée, supprimez des messages de l’historique
- Utilisez une fenêtre glissante (conservez le system + les N derniers tours)
- Passez à un modèle au contexte plus long
Délai dépassé / aucune réponse pendant longtemps
- Vérifiez la connectivité réseau :
curl https://hub.lurus.cn/v1/models - Réduisez
max_tokens - Les modèles de raisonnement (
deepseek-reasoner) ont un long temps de réflexion, c’est normal - Le délai par défaut du SDK est d’environ 60 secondes ; vous pouvez augmenter
timeout - Un délai persistant peut indiquer une panne en amont : changez de modèle et réessayez
Rien trouvé ? Contactez support@lurus.cn
X-Request-ID), l’heure de l’incident et les étapes de reproduction, pour un diagnostic rapide.