OneMux/Documentation/Questions fréquentes

Questions fréquentes

Une erreur survient lors d’un appel API ? Identifiez rapidement le problème grâce au code d’état. Cette page répertorie les codes d’erreur les plus courants et leurs solutions ; la plupart des problèmes peuvent être résolus en autonomie en moins d’une minute.

Diagnostic rapide

Lorsqu’une erreur survient, commencez par relever le code d’état HTTP (par exemple 401 ou 429), puis appliquez la solution correspondante :

Code d’étatCauseSolution
401API Key invalideVérifiez le format de la clé (sk-xxx) et sa validité
402Solde insuffisantRechargez votre compte depuis la console
404ID de modèle incorrectCopiez l’ID correct depuis la page du modèle
429Requêtes trop fréquentesRéduisez la fréquence et réessayez après 10 secondes
500Incident en amontRéessayez plus tard ou changez de modèle

401 - API Key invalide

Causes les plus courantes :

  • Des espaces ont été ajoutés lors de la copie
  • Le format est incorrect (la clé ne commence pas par sk-)
  • La clé a été supprimée

Solution rapide :

# ✅ 正确格式
api_key = "sk-1234567890abcdef"

# ❌ 常见错误
api_key = " sk-1234567890abcdef "  # 前后有空格
api_key = "1234567890abcdef"       # 缺少 sk- 前缀

Accédez à la console pour copier à nouveau la clé ou en créer une nouvelle.

402 - Solde insuffisant

Le solde du compte ne suffit pas à payer cette requête.

Accédez au centre de facturation pour recharger votre compte.

Remarque : Les requêtes avec un long contexte (par exemple, Gemini traitant 1 million de tokens) préautorisent le coût maximal possible. Veillez à disposer d’un solde suffisant.

404 - Modèle inexistant

Causes courantes :

  • L’ID du modèle contient une faute de frappe
  • Un ancien nom de modèle est utilisé (par exemple gpt-4o a été remplacé par gpt-6.1-sol)
  • Le chemin du Base URL est incorrect

Solution :

Obtenir l’ID correct du modèle

  1. 1

    Accéder à la page des modèles

    Ouvrez https://onemux.net/models

  2. 2

    Trouver le modèle souhaité

    Recherchez ou parcourez la liste pour trouver le modèle souhaité

  3. 3

    Copier l’ID du modèle

    Cliquez sur le bouton de copie ou copiez manuellement l’ID complet

Vérifiez que le Base URL est https://api.onemux.net/v1 (notez la présence de /v1 à la fin)

429 - Requêtes trop fréquentes

Un trop grand nombre de requêtes a été envoyé sur une courte période, ce qui a déclenché la limitation de fréquence.

Solution :

  • Réduisez la fréquence des requêtes
  • Attendez 10 à 30 secondes avant de réessayer
  • Ajoutez une logique de nouvelle tentative automatique (voir la documentation sur la gestion des erreurs)
  • Réduisez le nombre de tâches concurrentes

500/502/503 - Incident de service

Le service de modèle en amont est temporairement indisponible.

Solution :

  • Attendez 10 à 30 secondes avant de réessayer
  • Basculez vers un autre modèle
  • Consultez la page d’état pour connaître l’état du service

Ordre de diagnostic en cas de problème indéterminé

Diagnostic étape par étape

  1. 1

    Vérifier le solde

    Connectez-vous à la console et vérifiez que le solde est suffisant

  2. 2

    Vérifier l’API Key

    Recopiez la clé complète et assurez-vous qu’elle ne contient aucun espace

  3. 3

    Vérifier l’ID du modèle

    Recopiez-le depuis la page du modèle

  4. 4

    Vérifier le Base URL

    Vérifiez qu’il s’agit bien de https://api.onemux.net/v1

  5. 5

    Redémarrer le logiciel

    Enregistrez la configuration, puis redémarrez le client