Authentification

OneProvider accepte à la fois le Bearer de style OpenAI et le x-api-key de style Anthropic. Utilisez l’un ou l’autre, jamais les deux.

Formes d’en-tête

L’API accepte l’un ou l’autre des en-têtes. Utilisez celui que votre SDK envoie déjà.

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

Variables d’environnement

Nos exemples conservent la clé dans ONEPROVIDER_KEY. Les clients SDK, eux, lisent par défaut leurs propres noms natifs : soit exportez la clé sous ce nom, soit passez ONEPROVIDER_KEY explicitement au constructeur. Le tableau ci-dessous indique ce que lit chaque outil :

Vérifier l’authentification

Appelez /v1/models pour un contrôle peu coûteux et sans effet de bord :

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

Une réponse réussie liste les modèles actuels. Un 401 ici signifie que la clé est mal formée, révoquée ou pas encore active.

Où conserver la clé

• Variables d’environnement — le choix par défaut dans la plupart des cas.
• ~/.zshrc / ~/.bashrc avec HISTCONTROL=ignorespace défini, pour que les commandes précédées d’une espace n’entrent pas dans l’historique du shell.
• Gestionnaires de secrets : 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
• Fichiers .env par projet — toujours exclus par .gitignore.

Pièges courants

• Barre oblique finale. https://api.oneprovider.dev/v1/ ou https://api.oneprovider.dev/v1 — certains SDK concatènent le chemin naïvement. Utilisez la forme sans barre oblique finale ci-dessus.
• Double Bearer. Authorization: Bearer Bearer sk-... arrive quand un outil ajoute déjà Bearer en préfixe et que vous l’ajoutez à nouveau. Retirez le préfixe dans votre configuration.
• En-tête de version Anthropic. Incluez toujours anthropic-version: 2023-06-01 dans les appels HTTP bruts. Les SDK l’ajoutent pour vous.

Rotation des clés

Créez une nouvelle clé dans l’espace client (« Clés » → « Créer une clé »), mettez-la à jour dans vos clients, puis supprimez l’ancienne. C’est instantané et gratuit, et le solde est partagé par toutes les clés de l’espace client. En savoir plus : Espace client et clés .

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .