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_KEYavec le mot Bearer manquant.Authorization: Bearer: YOUR_KEYavec un deux-points supplémentaire.Authorization: Bearer "YOUR_KEY"avec des guillemets dans la valeur.Authorization: Bearer YOUR_KEYavec deux espaces.- Un en-tête nommé
X-API-Keyouapi-keyau lieu deAuthorization. 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.pyfonctionne, maisAPI_KEY=abcsur sa propre ligne n'est pas accessible aux processus enfants. Utilisezexport. - Masqué par une autre valeur. Les bibliothèques peuvent lire
OPENAI_API_KEYautomatiquement. 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 :
| Code | Signification habituelle | Où chercher |
|---|---|---|
| 401 | Clé manquante ou invalide | En-tête, clé, URL de base |
| 429 | Limite de débit ou surcharge temporaire | Réduisez le débit et réessayez ; consultez la documentation pour les limites |
| 400 | Corps de requête malformé | JSON, nom du modèle, paramètres |
| 404 | Mauvais chemin | URL 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.
