Comment tester une clé API IA avec curl et Python

Voici comment tester l'accès à la clé API sans rien construire : trois appels, environ deux minutes, et vous saurez si la clé est valide, financée et autorisée à générer du texte.
Points clés
- Appelez GET /v1/models en premier : cela prouve que la clé est acceptée sans dépenser de crédit.
- Envoyez une courte requête de chat au modèle uncensored pour confirmer que la génération fonctionne.
- Lisez l'en-tête X-Balance-USD ou appelez GET /v1/balance pour voir ce qui reste.
- 401 pointe vers la clé, 402 vers le solde, 429 vers votre taux de requêtes.
Le test en trois appels
Pour tester correctement une clé API IA, vous devez prouver trois choses distinctes : le serveur accepte la clé, la clé dispose d'un crédit et une complétion réelle est renvoyée. Une requête par question rend le diagnostic simple. En cas d'échec, vous savez quelle couche est en cause.
- Liste des modèles. Valide la clé et ne coûte rien.
- Complétion de chat. Confirme que le modèle répond et que le format de votre requête est correct.
- Solde. Confirme ce qu'il reste après le test.
Tout ce qui suit utilise l'URL de base https://api.aiapisource.com/v1 et l'ID de modèle uncensored. Mettez votre clé dans une variable d'environnement pour qu'elle ne finisse jamais dans l'historique de votre shell ou dans un dépôt.
export AIAPI_KEY="paste-your-key-here"
Si vous n'avez pas encore de clé, la page Clé API indique comment en créer une. Les nouveaux comptes peuvent réclamer un crédit d'essai de $0,50 en un seul clic, ce qui est largement suffisant pour chaque test de cet article.
Étape 1 : lister les modèles avec curl
Le contrôle le moins cher est une requête en lecture seule. GET /v1/models renvoie la liste des modèles et nécessite une clé valide, donc une réponse réussie prouve l'authentification.
curl -s https://api.aiapisource.com/v1/models \
-H "Authorization: Bearer $AIAPI_KEY"
Une réponse saine est un JSON avec un tableau data incluant uncensored. Si vous voyez une page HTML, une erreur de connexion ou une réponse vide, le problème vient de l'URL, pas de la clé. Vérifiez que vous avez conservé le suffixe /v1 et qu'il n'y a pas d'espace de fin après la clé dans votre variable.
Ajoutez -i à la commande curl pour afficher les en-têtes de réponse. L'API envoie X-Request-Id à chaque appel. Conservez cette valeur si vous contactez un jour le support, car elle identifie la requête exacte.
Étape 2 : envoyer une requête de chat
Vérifiez maintenant la génération. Gardez le prompt minuscule et limitez la sortie pour que le test coûte une fraction de centime.
curl -s https://api.aiapisource.com/v1/chat/completions \
-H "Authorization: Bearer $AIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the single word: ready"}],
"max_tokens": 10
}'
Recherchez choices[0].message.content et un objet usage avec prompt_tokens et completion_tokens. Une requête d'environ 20 tokens d'entrée et 5 tokens de sortie coûte 20 / 1 000 000 x $0.15 plus 5 / 1 000 000 x $0.50, soit environ $0.0000055. Vous pourriez en exécuter une centaine pour bien moins d'un centime.
Le même endpoint fonctionne aussi pour le streaming : ajoutez "stream": true et les tokens arrivent en tant qu'événements envoyés par le serveur. Testez cela séparément une fois que l'appel de base fonctionne.
Étape 3 : le même test en Python
Si votre code utilise un SDK OpenAI, testez également via le SDK. Il détecte des problèmes que curl ne verra pas, comme une URL de base passée au mauvais argument.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIAPI_KEY"],
base_url="https://api.aiapisource.com/v1",
)
print([m.id for m in client.models.list().data])
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the single word: ready"}],
max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)
Le premier print doit afficher une liste contenant uncensored. Le second montre la réponse du modèle. Pour un guide plus détaillé sur la configuration du SDK, consultez le guide Python de l'API OpenAI sur ce site.
Exécutez la version Python depuis le même shell où vous avez exporté la clé. Si elle lève une KeyError sur AIAPI_KEY, la variable n'est pas définie dans cette session, ce qui est la raison la plus courante d'échec d'un test avant même qu'il n'atteigne le réseau.
Node fonctionne de la même manière : passez baseURL: "https://api.aiapisource.com/v1" et la clé au constructeur du client OpenAI.
Vérifier le solde
Une clé peut être valide et ne rien avoir à dépenser. Deux façons de lire le solde :
curl -s https://api.aiapisource.com/v1/balance \
-H "Authorization: Bearer $AIAPI_KEY"
# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
-H "Authorization: Bearer $AIAPI_KEY"
Chaque réponse contient également un en-tête X-Balance-USD, donc l'appel de chat de l'étape 2 vous a déjà indiqué le crédit restant si vous l'avez exécuté avec -i. En Python, le SDK OpenAI expose cela via client.chat.completions.with_raw_response.create(...), où vous lisez response.headers["X-Balance-USD"].
Les requêtes échouées ou refusées ne sont pas facturées, donc un test qui génère une erreur ne consomme pas de crédit. Le crédit prépayé n'expire pas, ce qui signifie qu'un solde inutilisé sera toujours là la semaine prochaine.
Lire les codes d'erreur
Lorsqu'un test échoue, le statut HTTP permet d'identifier rapidement la cause.
| Statut | Signification habituelle | Que faire |
|---|---|---|
| 401 | La clé est manquante, mal tapée ou révoquée | Vérifiez l'en-tête Authorization: Bearer, recopiez la clé, recherchez des espaces ou des guillemets cachés |
| 402 | Plus de crédit pour payer la requête | Lisez le solde, puis reconstituez-le sur la page tarifaire |
| 404 | Mauvais chemin ou mauvais ID de modèle | Utilisez /v1/chat/completions et le modèle uncensored |
| 429 | Limite de débit ou de concurrence, ou surcharge de courte durée | Attendez et réessayez ; voir ci-dessous |
Un 429 contient un code d'erreur. rate_limited signifie trop de requêtes par minute et concurrency signifie trop de requêtes à la fois. Une clé complète permet 300 requêtes par minute et 8 requêtes concurrentes ; une clé d'essai permet 60 par minute et 2 à la fois. En cas de surcharge temporaire, l'API répond 429 avec Retry-After: 5, donc attendez cinq secondes et envoyez à nouveau la requête. Une requête en streaming conserve sa place de concurrence jusqu'à ce que le flux se termine, ce qui est une raison courante pour laquelle une clé d'essai atteint la limite lors de tests en parallèle.
Les codes d'état 401, 402 et 404 suivent les conventions API normales, donc traitez le tableau comme une première estimation et lisez le corps d'erreur JSON pour le message exact.
Un script de test de fumée réutilisable
Une fois le test manuel réussi, conservez un script que vous pouvez exécuter après avoir fait tourner les clés ou changé d'environnement.
import os, sys
import requests
BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}
m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)
c = requests.post(
BASE + "/chat/completions",
headers=H,
json={"model": "uncensored",
"messages": [{"role": "user", "content": "ping"}],
"max_tokens": 5},
timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)
Le code de sortie facilite l'intégration dans une vérification de déploiement. Pour les paramètres au-delà de ce minimum, la documentation de l'API liste tout ce que l'endpoint accepte.
Plus de guides
Questions et réponses
Le test d'une clé API coûte-t-il de l'argent ?
L'appel à la liste des modèles est gratuit. Une courte requête de chat avec un max_tokens faible coûte quelques millionièmes de dollar à 0,15 $ par 1 M de tokens en entrée et 0,50 $ par 1 M de tokens en sortie. Les requêtes échouées ne sont pas facturées.
Comment tester une clé sans carte ?
Obtenez le crédit d'essai de 0,50 $ sur la page de la clé API après vous être inscrit. Aucune carte n'est nécessaire et il est valable 7 jours, un par personne.
Pourquoi une clé valide renvoie-t-elle immédiatement une erreur 429 ?
Vous avez probablement atteint une limite de concurrence ou par minute. Les clés d'essai permettent 2 requêtes concurrentes et 60 par minute ; les clés complètes permettent 8 et 300. Vérifiez le code d'erreur, puis ralentissez ou réessayez après quelques secondes.
Puis-je tester la clé dans Postman ou une application au lieu de curl ?
Oui. Tout client compatible OpenAI fonctionne : définissez l'URL de base sur https://api.aiapisource.com/v1, collez la clé en tant que jeton Bearer et utilisez le modèle uncensored.
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.