Testeur de clé API IA : vérifiez une clé en 30 secondes

Pourquoi tester localement plutôt que sur une page web

La recherche d'un testeur de clé API IA renvoie beaucoup de pages où vous collez une clé et appuyez sur un bouton. Évitez-les. Une clé est un mot de passe qui dépense votre argent, et vous ne savez pas ce qu'une telle page en fait. Les tests ci-dessous prennent une demi-minute, s'exécutent sur votre propre machine et n'envoient la clé qu'à l'API que vous souhaitez utiliser.

Vous avez besoin de trois éléments : la clé, l'URL de base https://api.getaiapikey.com/v1 et l'ID du modèle uncensored. Placez la clé dans une variable d'environnement pour qu'elle ne finisse pas dans l'historique de votre shell ou dans un fichier que vous pourriez intégrer.

Copyexport API_KEY="paste-your-key-here"

Les clés proviennent de la page Clé API. Si vous n'en avez pas encore, les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai en un seul clic après la création de compte, ce qui est largement suffisant pour tous les tests de cet article, et ce à maintes reprises.

Vérification 1 : lister les modèles avec curl

Le test le moins cher est la liste des modèles. Il nécessite une clé valide et une URL de base correcte, et il ne génère aucun texte.

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Le drapeau -i affiche les en-têtes de réponse. Une réponse saine commence par HTTP/2 200 et un corps JSON qui inclut l'ID du modèle uncensored. Si vous voyez une erreur d'authentification à la place, généralement le statut 401, la clé est incorrecte, a été copiée avec un espace à la fin, ou l'en-tête manque le mot Bearer. Un 404 signifie que l'URL est incorrecte, le plus souvent à cause d'un /v1 manquant ou en double.

Vérification 2 : exécuter une vraie complétion

Une clé peut être valide et échouer quand même sur une vraie requête, par exemple parce que le solde est vide. Envoyez donc un petit appel chat et limitez la sortie pour garder le coût proche de zéro :

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

Lisez les en-têtes avant le corps. X-Request-Id identifie l'appel, ce qui est ce que le support demande. X-Balance-USD indique le crédit restant. X-RateLimit-Limit-Requests et X-RateLimit-Limit-Concurrency révèlent les limites de votre clé : 300 et 8 pour une clé complète, 60 et 2 pour une clé d'essai. Cet appel unique vérifie donc l'authentification, le modèle, le solde et le type de clé.

Le coût du test est négligeable. Un prompt d'environ 10 tokens et une réponse de 5 tokens coûtent 10 x $0,15 / 1M + 5 x $0,50 / 1M, soit environ $0,000004. Les requêtes échouées ou refusées ne sont pas facturées du tout.

Vérification 3 : le même test en Python

Si votre code réel utilise Python, testez-le comme il s'exécutera. Ce script utilise le package officiel openai, donc un succès ici signifie que la configuration de votre application fonctionne également :

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

Le wrapper with_raw_response donne accès aux en-têtes tandis que parse() retourne l'objet de réponse habituel. La configuration Python est couverte dans comment installer un client LLM en Python si l'import échoue.

Vérifiez votre solde sans complétion

Pour lire le solde sans générer de texte, appelez l'un des endpoints de solde. Il y en a un au style OpenAI et un plus court :

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

Les outils qui s'attendent déjà au format de crédits OpenAI peuvent utiliser le deuxième chemin sans modification. Ajoutez un appel comme celui-ci à un script de surveillance et vous recevrez un avertissement avant qu'un bot de production ne tombe à court. Les recharges commencent à 20 $ et le crédit n'expire jamais, il n'y a donc aucune pénalité à conserver une réserve confortable. Les montants et les bonus sont sur la page tarifs.

Transformez le test en vérification de santé

Une fois la clé fonctionnelle, conservez le test. Un petit script exécuté périodiquement vous signale un déploiement défectueux, un secret expiré ou un solde faible avant que vos utilisateurs ne le fassent. Voici une version Node utilisant le fetch intégré (Node 18 ou version ultérieure) :

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

Le script se termine avec un code non nul lorsque l'appel échoue ou que le solde tombe sous $5, afin qu'une tâche cron ou une étape CI puisse vous alerter. Choisissez le seuil en fonction de votre propre taux de consommation : à $2 par jour, $5 vous donne un peu plus de deux jours d'avertissement.

Ce qu'un test réussi ne prouve pas

Une coche verte montre que l'authentification, le routage et le modèle fonctionnent à ce moment-là, à faible charge. Cela ne montre pas comment votre application se comporte avec 20 utilisateurs à la fois. Pour cela, rappelez-vous les limites : une clé complète exécute 8 requêtes en même temps, et les requêtes streaming gardent leur emplacement jusqu'à la fin du flux. Testez la charge de votre propre code avec un cap sur les appels simultanés avant le lancement.

Lecture des échecs

Ce que vous voyez	Raison la plus probable	Que faire
Erreur d'authentification, souvent 401	Clé incorrecte, espace supplémentaire, préfixe Bearer manquant	Recopiez la clé, vérifiez la chaîne d'en-tête
404 ou HTML au lieu de JSON	URL de base incorrecte	Utilisez exactement https://api.getaiapikey.com/v1
Modèle non trouvé	ID de modèle différent dans la requête	Définissez model sur uncensored
429 avec rate_limited ou concurrency	Trop de requêtes par minute ou en même temps	Attendez, puis réessayez avec un délai
429 avec Retry-After: 5	Surcharge temporaire	Attendez 5 secondes et réessayez
Erreur de connexion ou de délai d'attente	Réseau, proxy ou pare-feu	Testez depuis un autre réseau, vérifiez les variables proxy

Les requêtes de plus de 8 Mo sont rejetées, donc si seuls les appels volumineux échouent, vérifiez la taille du corps. La documentation liste tous les codes d'erreur et les en-têtes.

Bonnes habitudes pour gérer une clé

• Conservez la clé dans une variable d'environnement ou un magasin de secrets, jamais dans le code côté client, un dépôt public ou une capture d'écran.
• Utilisez une clé par application si possible, afin qu'une fuite soit facile à tracer et à remplacer.
• Si une clé a pu être compromise, remplacez-la, puis vérifiez le solde pour une dépense inattendue.
• Ne partagez pas une clé d'essai entre plusieurs programmes : avec 2 requêtes simultanées, elle atteindra rapidement les limites.

Si vous voulez simplement voir s'il existe une option gratuite avant de vous inscrire, l'article sur une clé API LLM gratuite explique ce qui est disponible. Sinon, les trois vérifications ci-dessus sont tout ce dont une clé a besoin pour être testée.

Plus de guides

• Tarification des clés API IA : ce que coûte vraiment une clé
• Liste de contrôle de l'API IA