Configurez votre shell et vérifiez l'endpoint
Obtenez une clé depuis la page clé API, puis exportez-la ainsi que l'URL de base afin de ne pas coller de secrets dans chaque commande.
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
Chaque requête envoie la clé en tant que jeton bearer dans l'en-tête Authorization. Les corps de requête sont en JSON, ajoutez donc Content-Type: application/json lors du POST. La taille maximale du corps est de 8 Mo, ce qui ne concerne que si vous collez de très gros documents dans le prompt.
Les exemples utilisent les guillemets simples du shell Unix. Sur PowerShell sous Windows, placez le JSON dans un fichier et passez-le avec --data @body.json pour éviter les problèmes de guillemets.
Le test de base le moins cher est un GET qui liste les modèles. Il confirme la clé et l'URL, et ne coûte rien.
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
Le tableau data dans la réponse doit inclure l'ID uncensored. Un 401 signifie que la clé est manquante ou mal tapée. Si curl ne parvient pas à se connecter, vérifiez l'hôte dans $BASE et assurez-vous qu'il se termine par /v1 sans chemin supplémentaire.
1. Envoyer une complétion de chat
C'est la requête qu'envoie tout client compatible OpenAI en interne.
curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
La réponse est du JSON. Le texte se trouve à choices[0].message.content, et les comptes de tokens sont dans usage. Pipez la sortie avec jq -r '.choices[0].message.content' si vous avez jq installé et voulez uniquement le texte. Le champ max_tokens est optionnel ; laissez-le de côté et la complétion peut utiliser ce qui reste de la fenêtre de contexte de 100 000 tokens.
Le nouvel endpoint POST /v1/responses est également disponible si votre client utilise ce format. Pour la liste complète des paramètres, consultez la documentation.
2. Streamer la réponse
Ajoutez "stream": true et indiquez à curl de ne pas mettre en tampon avec -N. Les tokens s'imprimeront au fur et à mesure de leur génération.
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
Chaque ligne commence par data: et contient un petit chunk JSON avec un delta. Les derniers événements contiennent l'utilisation, et le flux se termine avec data: [DONE]. Sans -N, curl attend un tampon complet, et la sortie semble arriver en un seul bloc. Notez qu'une requête en streaming maintient un slot de concurrence occupé jusqu'à sa fin.
3. Demander du JSON
Pour une sortie que votre script analysera, activez le mode JSON avec response_format. Mentionnez le mot JSON dans le prompt pour que le modèle sache quelle forme vous attendez.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
Le filtre fromjson final analyse la chaîne dans content, donc jq échoue brutalement si le modèle a retourné autre chose qu'un JSON valide. Cela en fait un test rapide pratique. D'autres patterns sont sur la page mode JSON.
4. Essayer un appel d'outil
L'appel d'outils permet au modèle de demander à votre code d'exécuter une fonction. Vous décrivez la fonction dans un tableau tools, et si le modèle décide de l'utiliser, la réponse contient une entrée tool_calls au lieu de texte.
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
Vous devriez obtenir un nom de fonction et une chaîne JSON d'arguments. Votre code exécute la fonction, puis envoie une deuxième requête qui répète les messages précédents, ajoute le message assistant avec l'appel d'outil, et ajoute un message avec role: "tool" contenant le résultat. Le modèle écrit ensuite la réponse finale.
5. Vérifier les en-têtes et le solde
Ajoutez -i pour voir les en-têtes de réponse avec le corps. Vous y trouverez X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests et X-RateLimit-Limit-Concurrency.
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
Le deuxième appel renvoie votre crédit directement. Les outils compatibles OpenAI peuvent utiliser GET /v1/dashboard/billing/credit_grants à la place. Une petite requête comme celle ci-dessus coûte une fraction de centime : avec 10 tokens d'entrée et 5 tokens de sortie, le prix est 10 x 0,15 / 1 000 000 + 5 x 0,50 / 1 000 000 = 0,000004 $. Voir la page tarifs pour les tarifs.
Script de test de fumée réutilisable
Une fois que vous avez confiance dans les appels individuels, enveloppez-les dans un court script que vous pouvez exécuter après n'importe quel déploiement, rotation de clé ou changement réseau. Il échoue au premier problème, vous voyez ainsi exactement quelle étape a échoué.
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
L'indicateur -f fait sortir curl avec une erreur en cas d'échecs HTTP, et set -e arrête le script à cet endroit. Mettez-le dans un cron ou une étape CI si vous exécutez un service sur cette API et voulez un avertissement précoce en cas de changement. Conservez la clé dans un magasin de secrets ou une variable d'environnement, jamais dans le fichier de script lui-même.
Lorsque vous variez la requête, essayez un paramètre à la fois : temperature pour l'aléatoire, top_p pour l'échantillonnage du noyau, stop pour des séquences de fin personnalisées, et seed pour une sortie reproductible. Tous sont transmis au modèle, vous pouvez donc comparer leur effet depuis l'historique du même terminal.
Lire les erreurs de curl
| Code | Cause probable | Correction |
|---|---|---|
| 401 | Clé manquante ou incorrecte | Vérifiez l'en-tête Authorization et que $API_KEY est exporté |
| 400 | JSON malformé ou champ incorrect | Validez le corps avec jq . avant l'envoi |
429, code rate_limited | Plus de 300 requêtes par minute (60 sur une clé d'essai) | Ralentissez votre boucle |
429, code concurrency | Plus de 8 requêtes à la fois (2 sur une clé d'essai) | Exécutez moins de tâches en parallèle |
429 avec Retry-After: 5 | Surcharge temporaire | Attendez 5 secondes et réessayez |
Ajoutez -w "\n%{http_code}\n" pour afficher le code de statut après le corps, ce qui vous évite de deviner. Les corps d'erreur sont au format JSON avec un message et un code, donc jq .error les affiche proprement. Si vous voyez un 429 dans une boucle, ne réessayez pas immédiatement ; une pause de quelques secondes laisse le temps s'écouler pour la fenêtre par minute et les slots de concurrence, et une boucle de réessai serrée ne fait que vous maintenir au-dessus de la limite. Une clé d'essai a des limites plus strictes qu'une clé complète, donc un script qui fonctionne après votre premier rechargement peut échouer avec le crédit d'essai s'il exécute des tâches en parallèle. Une fois les requêtes stables, passez à un SDK ; la même URL et le même nom de modèle sont conservés sans changement. Les nouveaux comptes peuvent réclamer 0,50 $ de crédit d'essai en un clic, suffisant pour des centaines d'appels de test petits. Les recharges après cela commencent à 20 $ et sont payées en crypto (USDT sur TRC20 ou USDC sur Base).
