Hoe een AI API-sleutel testen met curl en Python

Zo test je toegang tot de AI API-sleutel zonder iets te bouwen: drie verzoeken, ongeveer twee minuten, en je weet of de sleutel geldig is, gefinancierd en toegestaan voor het genereren van tekst.
Belangrijkste punten
- Roep eerst GET /v1/models aan: dit bewijst dat de sleutel wordt geaccepteerd zonder dat er tegoed wordt besteed.
- Stuur één kort chatverzoek naar model uncensored om te bevestigen dat generatie werkt.
- Lees de X-Balance-USD header of GET /v1/balance om te zien wat er nog over is.
- 401 wijst naar de sleutel, 402 naar het saldo, 429 naar je verzoektempo.
De drie-verzoeken test
Om een AI API-sleutel goed te testen moet je drie aparte dingen bewijzen: de server accepteert de sleutel, de sleutel heeft tegoed erachter, en er komt een echte voltooiing terug. Eén verzoek per vraag houdt de diagnose eenvoudig. Als er iets misgaat, weet je welke laag schuldig is.
- Modellenlijst. Verifieert de sleutel en kost niets.
- Chat voltooiing. Bevestigt dat het model antwoordt en dat je verzoekformaat correct is.
- Saldo. Bevestigt wat er over is na de test.
Alles hieronder gebruikt de base URL https://api.aiapisource.com/v1 en de model-ID uncensored. Zet je sleutel in een omgevingsvariabele zodat deze nooit in je shell-geschiedenis of een repository terechtkomt.
export AIAPI_KEY="paste-your-key-here"
Als je nog geen sleutel hebt, toont de API-sleutelpagina hoe je er een maakt. Nieuwe accounts kunnen daar met één klik $0,50 proeftegoed claimen, wat meer dan genoeg is voor elke test in dit artikel.
Stap 1: modellenlijst met curl
De goedkoopste check is een alleen-lezen verzoek. GET /v1/models retourneert de modellenlijst en vereist een geldige sleutel, dus een succesvol antwoord bewijst authenticatie.
curl -s https://api.aiapisource.com/v1/models \
-H "Authorization: Bearer $AIAPI_KEY"
Een gezonde respons is JSON met een data-array die uncensored bevat. Als je een HTML-pagina, een verbindingsfout of een leeg antwoord ziet, is het probleem de URL, niet de sleutel. Controleer of je de /v1-suffix hebt behouden en dat er geen spatie achter de sleutel in je variabele staat.
Voeg -i toe aan het curl-commando om de antwoordheaders te zien. De API stuurt X-Request-Id bij elk verzoek. Bewaar die waarde als je ooit contact opneemt met support, omdat het het exacte verzoek identificeert.
Stap 2: één chatverzoek sturen
Controleer nu de generatie. Houd de prompt klein en beperk de output zodat de test een fractie van een cent kost.
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
}'
Zoek naar choices[0].message.content en een usage-object met prompt_tokens en completion_tokens. Een verzoek van ongeveer 20 input-tokens en 5 output-tokens kost 20 / 1.000.000 x $0,15 plus 5 / 1.000.000 x $0,50, wat ongeveer $0,0000055 is. Je kunt er honderd van uitvoeren voor minder dan een cent.
Hetzelfde endpoint werkt ook voor streaming: voeg "stream": true toe en tokens komen aan als server-sent events. Test dit apart zodra het basisverzoek werkt.
Stap 3: dezelfde test in Python
Als je echte code een OpenAI SDK gebruikt, test dan ook via de SDK. Deze vangt problemen op die curl niet ziet, zoals een basis-URL die aan het verkeerde argument wordt doorgegeven.
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)
De eerste print zou een lijst moeten bevatten met uncensored. De tweede toont het modelantwoord. Voor een uitgebreidere handleiding bij de SDK-setup, zie de OpenAI API Python guide op deze site.
Voer de Python-versie uit vanuit dezelfde shell waarin je de sleutel hebt geëxporteerd. Als het een KeyError op AIAPI_KEY geeft, is de variabele niet ingesteld in die sessie, wat de meest voorkomende reden is dat een test faalt voordat deze het netwerk ooit bereikt.
Node werkt op dezelfde manier: geef baseURL: "https://api.aiapisource.com/v1" en de sleutel mee aan de OpenAI client constructor.
Saldo controleren
Een sleutel kan geldig zijn en toch niets te besteden hebben. Twee manieren om het saldo te lezen:
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"
Elk antwoord bevat ook een X-Balance-USD-header, dus de verzoek van stap 2 gaf je al een indicatie van het resterende tegoed als je het met -i uitvoerde. In Python biedt de OpenAI SDK dit aan via client.chat.completions.with_raw_response.create(...), waar je response.headers["X-Balance-USD"] kunt lezen.
Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus een test die een fout geeft, verbruikt geen tegoed. Prepaid tegoed vervalt niet, wat betekent dat een ongebruikt saldo volgende week nog steeds aanwezig is.
Foutcodes lezen
Als een test faalt, beperkt de HTTP-status de oorzaak snel.
| Code | Gewone betekenis | Wat te doen |
|---|---|---|
| 401 | De sleutel ontbreekt, is verkeerd getypt of ingetrokken | Controleer de Authorization: Bearer-header, kopieer de sleutel opnieuw en controleer op verborgen spaties of aanhalingstekens |
| 402 | Geen krediet meer over om het verzoek te betalen | Lees het saldo, en laad op via de prijzenpagina |
| 404 | Verkeerd pad of verkeerde model-ID | Gebruik /v1/chat/completions en model uncensored |
| 429 | Tarief of concurrency limit, of korte overbelasting | Wacht en probeer opnieuw; zie hieronder |
Een 429 bevat een foutcode. rate_limited betekent te veel verzoeken per minuut en concurrency betekent te veel in één keer. Een volledige sleutel staat 300 verzoeken per minuut en 8 gelijktijdige verzoeken toe; een proefsleutel staat 60 per minuut en 2 in één keer toe. Bij tijdelijke overbelasting antwoordt de API met 429 en Retry-After: 5, dus wacht vijf seconden en stuur het verzoek opnieuw. Een gestreamd verzoek houdt zijn concurrency slot vast tot de stream klaar is, wat een veelvoorkomende reden is dat een proefsleutel de limiet raakt tijdens parallelle tests.
De statuscodes 401, 402 en 404 volgen normale API-conventies, dus behandel de tabel als een eerste inschatting en lees het JSON-foutbericht voor de exacte boodschap.
Een herbruikbaar rooktest-script
Zodra de handmatige test slaagt, houd je een script aan dat je kunt uitvoeren na het draaien van sleutels of het wijzigen van omgevingen.
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)
De exit-code maakt het eenvoudig om een deploy-check uit te voeren. Voor parameters die verder gaan dan dit minimum, somt de API docs alles op wat het endpoint accepteert.
Meer handleidingen
Vragen en antwoorden
Kost het testen van een API-sleutel geld?
De modellenlijst is gratis op te roepen. Een kort chatverzoek met een lage max_tokens kost een paar miljoendelen van een dollar bij $0,15 per 1M input tokens en $0,50 per 1M output tokens. Mislukte verzoeken worden niet in rekening gebracht.
Hoe test ik een sleutel zonder kaart?
Vraag de $0,50 proeftegoed aan op de API-sleutelpagina na het aanmelden. Het vereist geen kaart en is 7 dagen geldig, één per persoon.
Waarom geeft een geldige sleutel direct een 429?
Je hebt waarschijnlijk een limiet voor gelijktijdige verzoeken of per minuut geraakt. Proefsleutels staan 2 gelijktijdige verzoeken en 60 per minuut toe; volledige sleutels staan 8 en 300 toe. Controleer de foutcode, vertraag dan of probeer het na een paar seconden opnieuw.
Kan ik de sleutel testen in Postman of een app in plaats van curl?
Ja. Elke OpenAI-compatibele client werkt: stel de basis-URL in op https://api.aiapisource.com/v1, plak de sleutel als een Bearer-token en gebruik model uncensored.
Je sleutel is nog maar één stap verwijderd
Maak een account aan, kopieer de sleutel, pas de basis-URL aan. Dat is de hele installatie.