API de style OpenAI avec cURL et un jeton Bearer
Pour appeler une API de style OpenAI en ligne de commande, envoyez un POST HTTP avec un en-tête Authorization contenant votre token. Cette page fournit des commandes cURL fonctionnelles pour chaque fonctionnalité de cette API, ainsi que les vérifications à effectuer en cas d'échec.
Mis à jour le

Points clés
- Le token se place dans l'en-tête Authorization: Bearer YOUR_KEY, et l'ID du modèle est uncensored.
- Il existe deux endpoints : GET /v1/models et POST /v1/chat/completions.
- Ajoutez -N et stream true pour voir les tokens arriver via les événements envoyés par le serveur.
- Lisez X-Balance-USD et les en-têtes de limite de débit avec curl -i ; un code 429 signifie attendre et réessayer.
La requête minimale
Voici la méthode la plus courte pour effectuer open ai api curl with token contre ce service. Placez la clé dans une variable d'environnement pour éviter qu'elle n'apparaisse dans l'historique de votre shell, puis envoyez un message de chat :
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
La réponse est au format JSON avec la structure de complétion de chat OpenAI. La réponse se trouve à choices[0].message.content, et un objet usage rapporte les tokens de prompt et de complétion. Chaque partie de la commande a un rôle :
Authorization: Bearer ...transporte le jeton. "Bearer" est le nom du schéma ; quiconque détient le jeton est traité comme son propriétaire, c'est pourquoi vous devez le garder hors des dépôts publics.Content-Type: application/jsonindique au serveur comment lire le corps. Sans cela, la requête échoue souvent avec une erreur d'analyse du corps.modeldoit êtreuncensored, le seul modèle servi par cette API.messagesest une liste d'objets avec unrole(system, user, assistant ou tool) etcontent.
Pour obtenir une clé, inscrivez-vous avec Google ou email et mot de passe, puis utilisez la page des clés API. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai gratuit en un clic : sans carte, valable 7 jours, une fois par personne.
Vérifiez la clé avec GET /v1/models
Avant de déboguer une longue requête, confirmez que le token fonctionne avec l'appel le moins cher disponible. Lister les modèles ne coûte rien et montre si l'URL, l'en-tête et la clé sont corrects.
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
Une bonne réponse est une liste JSON incluant uncensored. Si vous avez jq installé, pipez la sortie pour extraire uniquement les identifiants :
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
Si rien d'utile ne revient, parcourez la liste ci-dessous dans l'ordre, car les causes sont listées par fréquence :
- La variable est vide. Exécutez
echo "${UF_KEY:0:6}"pour voir les premiers caractères sans afficher toute la clé. - L'en-tête est mal orthographié, ou "Bearer" manque avant la clé.
- Des guillemets courbes d'un document ou d'un client de chat ont remplacé les guillemets droits dans la commande.
- L'URL de base est fausse. Il s'agit de
https://api.unfilteredaimodels.com/v1, avecapi.devant et/v1à la fin. - La clé a été copiée avec un espace ou une nouvelle ligne à la fin.
Lisez les en-têtes de réponse
Ajoutez -i pour inclure les en-têtes dans la sortie, ou -D - pour les afficher tout en gardant le corps propre :
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
Quatre en-têtes de réponse méritent d'être connus :
| En-tête | Signification |
|---|---|
X-Request-Id | Identifiant pour cette requête. Citez-le si vous contactez le support. |
X-Balance-USD | Votre crédit prépayé restant. |
X-RateLimit-Limit-Requests | Requêtes par minute autorisées pour votre clé. |
X-RateLimit-Limit-Concurrency | Requêtes simultanées autorisées pour votre clé. |
Les limites sont de 300 requêtes par minute et 8 requêtes simultanées pour une clé complète, et de 60 par minute et 2 simultanées pour une clé d'essai. La requête ci-dessus définit max_tokens à 5 juste pour garder le test petit. En utilisation normale, max_tokens est optionnel, et la complétion peut utiliser tout ce qui reste de la fenêtre de 100 000 tokens après votre prompt.
Streaming en ligne de commande
Définissez "stream": true et ajoutez -N pour que curl ne mette pas en mémoire tampon la sortie. Vous verrez des lignes qui commencent par data:, chacune portant un petit delta JSON, et une dernière data: [DONE]. Le chunk qui le précède inclut l'utilisation des tokens.
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
Pour n'imprimer que le texte, filtrez le flux avec un court pipeline :
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
Une requête en streaming occupe son slot de concurrence jusqu'à la fin du flux. Si vous lancez de nombreux flux en parallèle depuis un script et que vous oubliez de les laisser se terminer, vous atteindrez la limite de concurrence même si le taux de requêtes est faible.
Mode JSON et appels d'outils
Le mode JSON fait retourner au modèle un seul objet JSON valide. Indiquez la forme souhaitée dans le prompt, sinon les clés seront celles que le modèle choisira.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
L'appel d'outils utilise les champs standards tools et tool_choice. Le modèle répond avec un tableau tool_calls au lieu de texte ; vous exécutez la fonction vous-même et renvoyez le résultat en tant que message avec role: "tool" et le tool_call_id correspondant.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
Dans la réponse, cherchez choices[0].message.tool_calls[0].function.arguments. C'est une chaîne JSON que vous analysez, appelez avec votre propre fonction météo, et renvoyez dans la requête suivante. Les paramètres tels que temperature, top_p, stop, seed et les pénalités sont transmis. La documentation liste tous les champs pris en charge.
Gardez le token en sécurité et les commandes propres
Un jeton Bearer est un mot de passe avec un autre nom. Quiconque le possède peut dépenser votre crédit, traitez-le avec la même attention. Ne collez jamais une clé réelle dans un problème public, une capture d'écran ou un journal de terminal partagé. Si vous soupçonnez qu'une clé a fuit, remplacez-la depuis la page des clés et mettez à jour vos scripts.
L'historique du shell est la fuite la plus courante sur une machine personnelle. Taper la clé directement dans une commande la stocke dans le fichier d'historique. La définir une fois avec export stocke aussi cette ligne. Deux habitudes plus propres aident. Lisez la clé depuis un fichier que seul vous pouvez ouvrir, ou préfixez la commande d'un espace si votre shell est configuré pour ignorer les lignes commençant par un espace. Un petit fichier fonctionne bien :
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
Les corps JSON longs sont difficiles à lire à l'intérieur des guillemets simples, et la citation échoue dès que le prompt contient une apostrophe. Placez le corps dans un fichier et laissez curl le lire avec -d @file :
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
La même approche permet de garder les prompts volumineux sous la limite de corps de 8 Mo, ce qui les rend gérables, et un fichier peut être versionné dans git tandis que la clé reste en dehors du dépôt. Sur PowerShell Windows, les guillemets simples autour du JSON se comportent différemment et la continuation de ligne avec antislash n'existe pas ; la forme -d @request.json évite ces deux problèmes, et vous pouvez utiliser un accent grave à la fin d'une ligne pour continuer une commande.
Une fois vos tests terminés, passez à un SDK. Les bibliothèques Python et Node.js OpenAI acceptent la même URL de base et la même clé, gèrent les réessais et le streaming pour vous, et lisent le même format de réponse que vous avez analysé à la main ici. Les commandes cURL restent le moyen le plus rapide de vérifier si un échec provient de votre code ou de la requête elle-même, alors gardez une commande connue pour fonctionner dans vos notes. Lorsque vous signalez un problème au support, incluez l'X-Request-Id de l'appel en échec et le code d'état exact ; ce couple permet à quelqu'un de trouver la requête sans vous demander de répéter le test, et cela économise un aller-retour de va-et-vient.
Erreurs, réessais et coût par appel
Lorsque vous dépassez une limite, l'API répond HTTP 429. Le code d'erreur indique quelle limite : rate_limited signifie trop de requêtes par minute, concurrency signifie trop de requêtes simultanées. Une surcharge temporaire renvoie aussi 429 et ajoute Retry-After: 5. Curl peut réessayer pour les erreurs transitoires :
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
Gardez également le corps sous 8 MB, ce qui est important si vous envoyez des fichiers encodés dans le prompt.
Les requêtes échouées ou refusées ne sont pas facturées. Celles qui réussissent suivent une formule simple : 0,15 $ par 1 M de tokens d'entrée et 0,50 $ par 1 M de tokens de sortie. Un appel de test avec 40 tokens d'entrée et 120 tokens de sortie coûte 40 / 1 000 000 x 0,15 $ = 0,000006 $ plus 120 / 1 000 000 x 0,50 $ = 0,00006 $, soit 0,000066 $ au total. Un millier d'entre eux s'élèvent à 0,066 $.
Le crédit est prépayé et n'expire jamais. Les recharges vont de 20 $ à 500 $ en montants entiers, avec un bonus de 5 % à partir de 50 $, 10 % à partir de 100 $ et 15 % à partir de 200 $, par crypto (USDT sur TRC20, USDC sur Base). La page de tarification affiche les détails. Si une réponse semble incorrecte, la page des mythes et des faits explique ce que le modèle fait et ne fait pas.
Plus de guides
Questions et réponses
Votre clé est à un formulaire de vous
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.
Où place-t-on le token dans une commande cURL ?
- Dans un en-tête : -H "Authorization: Bearer YOUR_KEY". Le corps de la requête doit également inclure l'en-tête Content-Type: application/json.
Quel nom de modèle utiliser ?
- Utilisez uncensored. Vous pouvez le confirmer avec GET /v1/models.
Pourquoi obtient-on une erreur 429 ?
- Vous avez dépassé une limite. Le code rate_limited signifie trop de requêtes par minute, concurrency signifie trop de requêtes simultanées. Attendez quelques secondes ou réduisez le nombre de requêtes simultanées.
Comment voir le crédit restant ?
- Chaque réponse inclut un en-tête X-Balance-USD. Affichez les en-têtes avec curl -i ou curl -D -.
S'agit-il de l'API OpenAI officielle ?
- Non. Il s’agit d’un service indépendant compatible OpenAI exécutant un modèle à poids ouverts, de sorte que les SDK et les commandes cURL conçus pour le format OpenAI fonctionnent après avoir modifié l’URL de base et la clé API.