FR ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
Obtenir une clé API

Erreur 401 de l'API LLM : corriger les échecs d'authentification

Une erreur 401 de l'API LLM signifie que le serveur n'a pas pu authentifier votre requête. Dans presque tous les cas, la cause est du côté du client : un en-tête mal tapé, une clé contenant un caractère parasite ou une requête envoyée au mauvais hôte. Ce guide passe en revue les vérifications dans l'ordre qui permet de trouver le problème le plus rapidement.

Mis à jour

Une clé qui ne correspond pas à un cadenas lumineux, illustrant un échec d'authentification lors de l'appel à une API LLM

Points clés

  1. 401 est un échec d'authentification, et non une limite de débit ou une erreur de facturation.
  2. L'en-tête doit être exactement Authorization: Bearer VOTRE_CLE, avec un seul espace et sans guillemets.
  3. Une clé envoyée à la mauvaise URL de base échoue tout comme une clé incorrecte.
  4. Testez d'abord avec curl ; si curl fonctionne, le bug se trouve dans la configuration de votre application.

Lancez ce test curl d'abord

Avant de modifier le code, retirez votre application de l'équation. Cette seule commande envoie la requête minimale valide à l'API :

curl -i https://api.unrestrictedaiapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

GET /v1/models ne coûte rien, c'est donc un moyen sûr de tester une clé. L'indicateur -i affiche la ligne d'état et les en-têtes.

  • 200 et une liste de modèles : la clé est correcte. Votre application envoie quelque chose de différent, passez donc aux sections sur les variables d'environnement et l'URL de base.
  • 401: la clé ou l'en-tête est incorrect. Passez à la section suivante.
  • Erreur de connexion ou de DNS : l'URL de base est incorrecte, ce qui est un problème différent du 401.

Collez la clé manuellement dans ce test, pas via une variable. Cela retire l'environnement de la liste des suspects.

Cause 1 : l'en-tête n'est pas tout à fait correct

L'API attend Authorization: Bearer <key>. De petites écarts produisent tous une erreur 401 de l'API LLM :

  • Authorization: YOUR_KEY avec le mot Bearer manquant.
  • Authorization: Bearer: YOUR_KEY avec un deux-points supplémentaire.
  • Authorization: Bearer "YOUR_KEY" avec des guillemets dans la valeur.
  • Authorization: Bearer YOUR_KEY avec deux espaces.
  • Un en-tête nommé X-API-Key ou api-key au lieu de Authorization. Ce sont des conventions d'autres services.

Si vous utilisez le SDK OpenAI, vous n'écrivez pas l'en-tête vous-même. Le SDK le construit à partir de l'argument api_key. Si vous voyez un 401 malgré tout, la valeur passée au SDK est le problème, et non le format de l'en-tête.

Cause 2 : la clé elle-même est endommagée

Les clés sont de longues chaînes aléatoires, les erreurs de copie sont donc fréquentes et difficiles à repérer à l'œil.

  • Nouvelle ligne ou espace en fin de chaîne. La copie depuis un terminal ou un fichier texte en ajoute souvent une. De nombreuses bibliothèques HTTP envoient alors un en-tête invalide ou une clé qui ne correspond pas.
  • Clé tronquée. Un double-clic ne sélectionne qu'une partie de la chaîne si la clé contient des caractères qui interrompent la sélection de mots. Utilisez plutôt le bouton copier sur la page clé API.
  • Guillemets courbes. Le collage via un traitement de texte ou une application de chat peut remplacer les guillemets droits par des guillemets courbes.
  • Ancienne clé ou clé rotée. Si vous avez créé une nouvelle clé, l'ancienne n'est peut-être plus celle que vous utilisez.

Pour vérifier la présence de caractères invisibles en Python, affichez le repr de la valeur :

import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))

Si la deuxième ligne affiche False, vous avez des espaces autour de la clé. Appelez .strip() lors de sa lecture.

Cause 3 : la mauvaise URL de base

C'est l'erreur la plus courante lors du passage d'une application existante à un nouveau fournisseur. Votre clé n'est valide que sur l'hôte qui l'a émise. L'URL de base de ce site est :

{"base_url": "https://api.unrestrictedaiapi.com/v1"}

Deux modèles d'échec se reproduisent encore et encore :

  • Vous avez défini la nouvelle clé mais laissé l'ancienne URL de base. La requête va vers l'ancien fournisseur, qui rejette une clé qu'il n'a jamais vue et renvoie un 401. Le texte d'erreur mentionne alors l'ancien fournisseur, ce qui est un indice utile.
  • Vous avez défini la nouvelle URL de base mais laissé une ancienne clé dans l'environnement. La requête nous atteint, et nous rejetons la clé de l'autre fournisseur.

Vérifiez également le chemin. L'URL de base se termine déjà par /v1, donc les SDK ajoutent /chat/completions à celle-ci. Si vous construisez l'URL à la main, le chemin complet est /v1/chat/completions, et non /v1/v1/chat/completions.

Cause 4 : variables d'environnement et fichiers de configuration

Si curl fonctionne mais que votre application échoue, quelque chose alimente l'application avec une clé différente de celle que vous pensez.

  • Variable non exportée. Dans un shell, API_KEY=abc python app.py fonctionne, mais API_KEY=abc sur sa propre ligne n'est pas accessible aux processus enfants. Utilisez export.
  • Masqué par une autre valeur. Les bibliothèques peuvent lire OPENAI_API_KEY automatiquement. Si une ancienne est définie dans votre profil shell, elle peut écraser ce que vous avez prévu.
  • Guillemets dans un fichier .env. Certains chargeurs conservent les guillemets comme partie de la valeur. Si votre clé arrive entourée de caractères de guillemets, supprimez-les ou testez avec le vérificateur repr ci-dessus.
  • Non redémarré. Les serveurs et les notebooks lisent les variables d'environnement au démarrage. Redémarrez après l'édition.
  • Environnement différent en production. Les conteneurs, CI et les tableaux de bord d'hébergement ont chacun leur propre magasin de variables. Affichez la longueur de la clé, jamais la clé elle-même, dans les journaux.

Un script Python minimal qui vérifie la configuration

Ce script utilise le SDK OpenAI et signale clairement si l'authentification échoue :

import os
from openai import OpenAI, AuthenticationError

client = OpenAI(
    base_url="https://api.unrestrictedaiapi.com/v1",
    api_key=os.environ["API_KEY"].strip(),
)

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Reply with the word ok."}],
        max_tokens=5,
    )
    print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
    print("401:", e.status_code, e.response.headers.get("X-Request-Id"))

Si cela affiche un X-Request-Id, incluez-le lorsque vous écrivez à support, car il permet à l'équipe de trouver votre requête. La même vérification dans d'autres langages se trouve dans le guide de démarrage rapide pour cinq langages.

401 par rapport aux autres erreurs

Ne perdez pas de temps sur l'authentification si l'erreur est autre. Un court guide :

CodeSignification habituelleOù chercher
401Clé manquante ou invalideEn-tête, clé, URL de base
429Limite de débit ou surcharge temporaireRéduisez le débit et réessayez ; consultez la documentation pour les limites
400Corps de requête malforméJSON, nom du modèle, paramètres
404Mauvais cheminURL de base et endpoint

Vérifiez également le nom du modèle. Utilisez uncensored exactement ; un ID de modèle incorrect est une erreur de requête, pas une 401. Les détails de l’API, y compris les endpoints et les en-têtes acceptés, figurent sur la page spécification API compatible OpenAI.

Proxies, navigateurs et solutions de dernier recours

Deux configurations provoquent des 401 qui semblent surprenants.

Proxies et passerelles

Un proxy inverse, une passerelle API ou un adaptateur serverless entre votre application et l'API peut supprimer ou réécrire l'en-tête Authorization. Testez depuis la même machine avec curl et comparez. Certains frameworks ne transfèrent l'en-tête qu'aux hôtes de même origine, de sorte qu'un adaptateur fetch personnalisé peut le perdre silencieusement lors d'un appel cross-origin.

Clés dans le code front-end

Appeler l’API directement depuis du JavaScript dans le navigateur expose la clé à quiconque ouvre les outils de développement, et les navigateurs peuvent également bloquer la requête pour des raisons cross-origin qui ressemblent à des erreurs d’authentification. Conservez la clé sur un serveur et faites en sorte que votre front-end appelle votre propre endpoint, qui à son tour appelle l’API avec la clé attachée. Si une clé a été collée dans du code public ou une capture d’écran, remplacez-la.

Toujours bloqué

Si une clé fraîchement copiée renvoie toujours 401 lors du test curl, générez à nouveau la clé depuis la page des clés API, collez-la directement dans la commande, et réessayez une fois de plus. Si cela échoue, envoyez au support l'heure de la requête, l'endpoint et l'en-tête de réponse X-Request-Id. N'envoyez jamais la clé complète dans un message ; les quatre premiers et les quatre derniers caractères suffisent à l'identifier.

Questions et réponses

Un 401 signifie-t-il que je n’ai plus de crédit ?

Non. Un 401 concerne l’authentification : la clé est manquante, malformée ou inconnue. La fin du crédit est un état distinct.

Pourquoi la même clé fonctionne-t-elle dans curl mais pas dans mon application ?

Votre application lit probablement une valeur différente, telle qu’une ancienne variable d’environnement, une entrée .env entre guillemets ou une clé avec des espaces en fin de chaîne. Affichez la longueur et la représentation de la clé que votre code utilise réellement.

Puis-je utiliser ma clé OpenAI avec cette API ?

Non. Chaque clé fonctionne uniquement sur l’hôte qui l’a émise. Utilisez la clé de la page des clés API avec l’URL de base de ce site.

Un 401 est-il facturé ?

Non. Les requêtes échouées ou refusées ne sont pas facturées.

Votre clé n'est qu'à un formulaire d'ici

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API