AI API-sleuteltester: controleer een sleutel in 30 seconden

Waarom lokaal testen in plaats van op een webpagina

Zoeken naar een AI API-sleuteltester levert veel pagina's op waar je een sleutel plakt en op een knop drukt. Vermijd ze. Een sleutel is een wachtwoord dat je geld verbruikt, en je weet niet wat zo'n pagina ermee doet. De tests hieronder duren een halve minuut, draaien op je eigen machine en sturen de sleutel alleen naar de API die je wilt gebruiken.

Je hebt drie dingen nodig: de sleutel, de base URL https://api.getaiapikey.com/v1 en de model ID uncensored. Zet de sleutel in een environment variable zodat deze niet in je shell history terechtkomt of in een bestand dat je misschien commit.

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

Sleutels vind je op de API-sleutelpagina. Heb je er nog geen? Nieuwe gebruikers kunnen na het inloggen met één klik $0,50 aan proeftegoed claimen. Dat is genoeg om elke test in dit artikel vele malen uit te voeren.

Controle 1: modellenlijst met curl

De goedkoopste test is de modellenlijst. Deze vereist een geldige sleutel en een correcte base URL, en genereert geen tekst.

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

De -i-flag print de response headers. Een gezond antwoord begint met HTTP/2 200 en een JSON-lichaam dat de model ID uncensored bevat. Als je in plaats daarvan een authenticatiefout ziet, meestal status 401, is de sleutel verkeerd, werd gekopieerd met een trailing space, of de header mist het woord Bearer. Een 404 betekent dat de URL verkeerd is, meestal een ontbrekende /v1 of een verdubbeling.

Controle 2: één echte completion uitvoeren

Een sleutel kan geldig zijn en toch falen bij een echt verzoek, bijvoorbeeld omdat het saldo leeg is. Stuur dus een kleine chatcall en beperk de output om de kosten bijna nul te houden:

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."}]}'

Lees de headers voor de body. X-Request-Id identificeert de call, wat support vraagt. X-Balance-USD toont hoeveel tegoed er nog over is. X-RateLimit-Limit-Requests en X-RateLimit-Limit-Concurrency onthullen de limieten van je sleutel: 300 en 8 voor een volledige sleutel, 60 en 2 voor een proefsleutel. Die ene call controleert dus authenticatie, het model, het saldo en het sleuteltype.

De prijs van de test is verwaarloosbaar. Een prompt van ongeveer 10 tokens en een antwoord van 5 tokens kost 10 x $0,15 / 1M + 5 x $0,50 / 1M, wat ongeveer $0,000004 is. Mislukte of geweigerde verzoeken worden helemaal niet in rekening gebracht.

Controle 3: dezelfde test in Python

Als je echte code Python gebruikt, test het dan op de manier waarop de code zal draaien. Dit script gebruikt de officiële openai-package, dus een geslaagde test betekent dat je applicatie-inrichting ook werkt:

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)

De with_raw_response-wrapper geeft toegang tot de headers terwijl parse() het gebruikelijke antwoordobject retourneert. De Python-inrichting zelf wordt behandeld in hoe een LLM-client in Python te installeren als het importeren mislukt.

Controleer je saldo zonder een completion

Om het saldo te lezen zonder tekst te genereren, roep je een van de saldo-endpoints aan. Er is er in OpenAI-stijl en een korte:

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"

Tools die het OpenAI-formaat voor tegoed al verwachten, kunnen het tweede pad ongewijzigd gebruiken. Voeg een aanroep zoals deze toe aan een monitoring-script en je krijgt een waarschuwing voordat een productiebot op raakt. Opwaarderingen beginnen bij $20 en tegoed vervalt nooit, dus er is geen nadeel aan het houden van een comfortabele reserve. Bedragen en bonussen staan op de prijzenpagina.

Maak van de test een gezondheidscontrole

Zodra de sleutel werkt, houd de test. Een klein script dat op schema draait, vertelt je over een slechte deploy, een verlopen geheim of een laag saldo voordat je gebruikers dat doen. Hier is een Node-versie met de ingebouwde fetch (Node 18 of nieuwer):

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();

Het script stopt met een niet-nul code als de call faalt of het saldo onder $5 zakt, zodat een cron-taak of CI-stap je kan waarschuwen. Kies de drempel op basis van je eigen verbruik: bij $2 per dag geeft $5 je iets meer dan twee dagen waarschuwing.

Wat een geslaagde test niet bewijst

Een groen vinkje toont dat auth, routing en het model op dat moment werken, bij lage belasting. Het toont niet hoe je applicatie zich gedraagt met 20 gebruikers tegelijk. Onthoud voor dat doel de limieten: een volledige sleutel voert 8 verzoeken gelijktijdig uit, en gestreamde verzoeken houden hun slot vast tot de stream eindigt. Test je eigen code met een limiet op gelijktijdige aanroepen voor de lancering.

Fouten lezen

Wat je ziet	Meest waarschijnlijke reden	Wat te doen
Authenticatiefout, vaak 401	Verkeerde sleutel, extra spaties, geen Bearer-voorvoegsel	Kopieer de sleutel opnieuw, controleer de headerstring
404 of HTML in plaats van JSON	Verkeerde basis-URL	Gebruik exact https://api.getaiapikey.com/v1
Model niet gevonden	Andere model ID in het verzoek	Stel model in op uncensored
429 met rate_limited of concurrency	Te veel verzoeken per minuut of tegelijk	Wacht, en probeer het opnieuw met een vertraging
429 met Retry-After: 5	Tijdelijke overbelasting	Wacht 5 seconden en probeer opnieuw
Verbindings- of time-outfout	Netwerk, proxy of firewall	Test vanaf een ander netwerk, controleer proxy variabelen

Verzoeken boven de 8 MB worden afgewezen, dus als alleen grote aanroepen mislukken, controleer dan de grootte van het lichaam. De documentatie somt alle foutcodes en headers op.

Goede gewoonten voor het omgaan met een sleutel

• Bewaar de sleutel in een omgevingsvariabele of een secret store, nooit in clientcode, een openbare repository of een screenshot.
• Gebruik één sleutel per applicatie waar dat kan, zodat een lek makkelijk te traceren en vervangen is.
• Als een sleutel mogelijk gelekt is, vervang hem dan en kijk naar het saldo voor onverwachte uitgaven.
• Deel geen proefsleutel tussen meerdere programma's: met 2 gelijktijdige verzoeken raakt hij snel aan de limiet.

Als je alleen wilt zien of er een gratis optie bestaat voordat je je aanmeldt, legt het artikel over een gratis LLM API-sleutel uit wat er beschikbaar is. Anders zijn de drie controles hierboven alles wat een sleutel nodig heeft om te testen.

Meer handleidingen

• Prijzen voor AI API-sleutels: Wat zo'n sleutel echt kost
• AI API Checklist