DE ▾

So testest du einen AI-API-Schlüssel mit curl und Python

Ein Schlüssel, der in ein Schloss gesteckt wird, mit drei grünen Kontrollleuchten, die einen erfolgreichen API-Schlüsseltest darstellen

So testest du den Zugriff auf den AI API-Schlüssel, ohne etwas zu bauen: drei Aufrufe, etwa zwei Minuten, und du weißt, ob der Schlüssel gültig, mit Guthaben versehen und zur Textgenerierung berechtigt ist.

Aktualisiert

Wichtige Punkte

  • Rufe zuerst GET /v1/models auf: Das beweist, dass der Schlüssel akzeptiert wird, ohne Guthaben zu verbrauchen.
  • Sende eine kurze Chat-Anfrage an das Modell uncensored, um zu bestätigen, dass die Generierung funktioniert.
  • Lese den X-Balance-USD-Header oder GET /v1/balance, um den Restbetrag zu sehen.
  • 401 bezieht sich auf den Schlüssel, 402 auf den Kontostand, 429 auf deine Anfragerate.

Der Drei-Aufruf-Test

Um einen AI-API-Schlüssel richtig zu testen, musst du drei separate Dinge beweisen: Der Server akzeptiert den Schlüssel, der Schlüssel hat Guthaben hinterlegt und es kommt eine echte Completion zurück. Ein Aufruf pro Frage hält die Diagnose einfach. Bei einem Fehler weißt du, welche Schicht schuld ist.

  1. Modellliste. Authentifiziert den Schlüssel und kostet nichts.
  2. Chat-Vervollständigung. Bestätigt, dass das Modell antwortet und Ihr Anfrageformat korrekt ist.
  3. Guthaben. Bestätigt, was nach dem Test noch übrig ist.

Alles unten verwendet die Base URL https://api.aiapisource.com/v1 und die Modell-ID uncensored. Lege deinen Schlüssel in einer Umgebungsvariable ab, damit er niemals in deiner Shell-History oder einem Repository landet.

export AIAPI_KEY="paste-your-key-here"

Wenn du noch keinen Schlüssel hast, zeigt die API-Schlüssel-Seite, wie du einen erstellst. Neue Konten können dort mit einem Klick ein $0,50 Trial-Guthaben beanspruchen, was für jeden Test in diesem Artikel mehr als ausreichend ist.

Schritt 1: Modelle mit curl auflisten

Die günstigste Prüfung ist eine schreibgeschützte Anfrage. GET /v1/models gibt die Modellliste zurück und erfordert einen gültigen Schlüssel, also beweist eine erfolgreiche Antwort die Authentifizierung.

curl -s https://api.aiapisource.com/v1/models \
  -H "Authorization: Bearer $AIAPI_KEY"

Eine gesunde Antwort ist JSON mit einem data-Array, das uncensored enthält. Siehst du eine HTML-Seite, einen Verbindungsfehler oder eine leere Antwort, ist die URL das Problem, nicht der Schlüssel. Prüfe, ob du das /v1-Suffix beibehalten hast und ob nach dem Schlüssel in deiner Variable kein Leerzeichen am Ende steht.

Füge -i zum curl-Befehl hinzu, um die Antwort-Header zu sehen. Die API sendet X-Request-Id bei jedem Aufruf. Behalte diesen Wert, falls du den Support kontaktierst, da er die genaue Anfrage identifiziert.

Schritt 2: eine Chat-Anfrage senden

Prüfe nun die Generierung. Halte den Prompt klein und begrenze die Ausgabe, damit der Test nur einen Bruchteil eines Cents kostet.

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
  }'

Achte auf choices[0].message.content und ein usage-Objekt mit prompt_tokens und completion_tokens. Eine Anfrage mit ca. 20 Input-Token und 5 Output-Token kostet 20 / 1.000.000 x $0,15 plus 5 / 1.000.000 x $0,50, also ca. $0,0000055. Du könntest hundert davon für weit unter einem Cent ausführen.

Der gleiche Endpunkt funktioniert auch für Streaming: Füge "stream": true hinzu und Tokens kommen als Server-Sent Events an. Teste das separat, sobald der Basis-Aufruf funktioniert.

Schritt 3: Der gleiche Test in Python

Wenn dein echter Code ein OpenAI SDK verwendet, teste auch über das SDK. Es fängt Probleme ab, die curl nicht sieht, wie eine Base URL, die an das falsche Argument übergeben wird.

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)

Die erste Ausgabe sollte eine Liste mit uncensored anzeigen. Die zweite zeigt die Modellantwort. Eine ausführlichere Anleitung zur SDK-Einrichtung findest du im OpenAI API Python Guide auf dieser Website.

Führe die Python-Version aus derselben Shell aus, in der du den Schlüssel exportiert hast. Wenn es einen KeyError für AIAPI_KEY wirft, ist die Variable in dieser Sitzung nicht gesetzt, was der häufigste Grund für einen Testfehler ist, bevor er das Netzwerk erreicht.

Node funktioniert genauso: Übergebe baseURL: "https://api.aiapisource.com/v1" und den Schlüssel an den OpenAI-Client-Konstruktor.

Guthaben prüfen

Ein Schlüssel kann gültig sein und trotzdem nichts zum Ausgeben haben. Zwei Möglichkeiten, das Guthaben zu lesen:

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"

Jede Antwort enthält auch den X-Balance-USD-Header, sodass der Chat-Aufruf aus Schritt 2 dir bereits das verbleibende Guthaben angezeigt hat, wenn du ihn mit -i ausgeführt hast. In Python bietet das OpenAI SDK dies über client.chat.completions.with_raw_response.create(...) an, wobei du response.headers["X-Balance-USD"] ausliest.

Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, also frisst ein Test, der fehlschlägt, kein Guthaben. Prepaid-Guthaben verfällt nicht, was bedeutet, dass ein ungenutzter Restbetrag auch nächste Woche noch da ist.

Fehlercodes lesen

Wenn ein Test fehlschlägt, schränkt der HTTP-Status schnell ein.

CodeÜbliche BedeutungWas tun
401Der Schlüssel fehlt, ist falsch getippt oder widerrufenÜberprüfe den Authorization: Bearer-Header, kopiere den Schlüssel erneut und suche nach versteckten Leerzeichen oder Anführungszeichen.
402Kein Guthaben mehr vorhanden, um die Anfrage zu bezahlenLese das Guthaben ab und lade dann auf der Preisseite auf.
404Falscher Pfad oder falsche Modell-IDVerwende /v1/chat/completions und das Modell uncensored.
429Raten- oder Concurrency-Limit oder kurze ÜberlastungWarten und wiederholen; siehe unten

Eine 429 enthält einen Fehlercode. rate_limited bedeutet zu viele Anfragen pro Minute und concurrency bedeutet zu viele gleichzeitig. Ein voller Schlüssel erlaubt 300 Anfragen pro Minute und 8 parallele Anfragen; ein Trial-Schlüssel erlaubt 60 pro Minute und 2 gleichzeitig. Bei temporärer Überlastung antwortet die API mit 429 und Retry-After: 5, also warte fünf Sekunden und sende die Anfrage erneut. Eine gestreamte Anfrage belegt ihren Concurrency-Slot, bis der Stream endet, was ein häufiger Grund ist, warum ein Trial-Schlüssel bei parallelen Tests das Limit erreicht.

Die Statuscodes 401, 402 und 404 folgen normalen API-Konventionen, also behandle die Tabelle als ersten Verdacht und lies den JSON-Fehlerbody für die genaue Nachricht.

Ein wiederverwendbares Smoke-Test-Skript

Sobald der manuelle Test bestanden ist, behalte ein Skript, das du nach dem Rotieren von Schlüsseln oder dem Ändern von Umgebungen ausführen kannst.

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)

Der Exit-Code erleichtert das Einfügen in eine Deploy-Prüfung. Für Parameter jenseits dieses Minimums listet die API-Dokumentation alles auf, was der Endpunkt akzeptiert.

Fragen und Antworten

Kostet das Testen eines API-Schlüssels Geld?

Die Modellauflistung ist kostenlos aufrufbar. Eine kurze Chat-Anfrage mit einem niedrigen max_tokens kostet nur wenige Millionstel Dollar: $0,15 pro 1 Mio. Input-Token und $0,50 pro 1 Mio. Output-Token. Fehlgeschlagene Anfragen werden nicht berechnet.

Wie teste ich einen Schlüssel ohne Karte?

Fordere das $0,50 Trial-Guthaben auf der API-Schlüssel-Seite nach der Anmeldung an. Es benötigt keine Karte und ist 7 Tage lang gültig, jeweils eine pro Person.

Warum gibt ein gültiger Schlüssel sofort 429 zurück?

Du hast wahrscheinlich ein Limit für parallele Anfragen oder ein Ratenlimit erreicht. Trial-Schlüssel erlauben 2 parallele Anfragen und 60 pro Minute; volle Schlüssel erlauben 8 und 300. Prüfe den Fehlercode, verlangsame dann oder versuche es nach einigen Sekunden erneut.

Kann ich den Schlüssel in Postman oder einer App statt mit curl testen?

Ja. Jeder OpenAI-kompatible Client funktioniert: Setze die Base URL auf https://api.aiapisource.com/v1, füge den Schlüssel als Bearer-Token ein und verwende das Modell uncensored.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel, ändere die Basis-URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhalten