AI-API-Schlüssel-Tester: Prüfe einen Schlüssel in 30 Sekunden

Warum lokal statt auf einer Webseite testen

Die Suche nach einem AI-API-Schlüssel-Tester führt zu vielen Seiten, auf denen du einen Schlüssel einfügst und einen Button drückst. Vermeide sie. Ein Schlüssel ist ein Passwort, das dein Geld verbraucht, und du kannst nicht wissen, was eine solche Seite damit macht. Die folgenden Tests dauern eine halbe Minute, laufen auf deiner eigenen Maschine und senden den Schlüssel nur an die API, die du nutzen möchtest.

Du brauchst drei Dinge: den Schlüssel, die Base URL https://api.getaiapikey.com/v1 und die Model ID uncensored. Lege den Schlüssel in einer Umgebungsvariable ab, damit er nicht in deiner Shell-History oder in einer Datei landet, die du committest.

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

Die Schlüssel findest du auf der API-Schlüssel-Seite. Wenn du noch keinen hast, können neue Nutzer nach der Anmeldung mit einem Klick $0,50 kostenloses Testguthaben beanspruchen, was für jeden Test in diesem Artikel mehr als ausreicht.

Prüfung 1: Modelle mit curl auflisten

Der günstigste Test ist die Modellliste. Sie benötigt einen gültigen Schlüssel und eine korrekte Base URL und generiert keinen Text.

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

Das Flag -i gibt die Antwort-Header aus. Eine funktionale Antwort beginnt mit HTTP/2 200 und einem JSON-Body, der die Modell-ID uncensored enthält. Wenn stattdessen ein Authentifizierungsfehler erscheint, meist Status 401, ist der Schlüssel falsch, wurde mit einem Leerzeichen am Ende kopiert oder der Header fehlt das Wort Bearer. Ein 404 bedeutet, dass die URL falsch ist, meist fehlt ein /v1 oder es ist eines zu viel.

Prüfung 2: Eine echte Completion ausführen

Ein Schlüssel kann gültig sein, aber bei einer echten Anfrage fehlschlagen, zum Beispiel weil das Guthaben leer ist. Sende also einen kleinen Chat-Aufruf und begrenze die Ausgabe, um die Kosten nahe Null zu halten:

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

Lies die Header vor dem Körper. X-Request-Id identifiziert den Aufruf, nach dem der Support fragt. X-Balance-USD zeigt, wie viel Guthaben noch übrig ist. X-RateLimit-Limit-Requests und X-RateLimit-Limit-Concurrency zeigen die Limits deines Schlüssels: 300 und 8 für einen Vollschlüssel, 60 und 2 für einen Test-Schlüssel. Dieser eine Aufruf prüft also Authentifizierung, Modell, Guthaben und Schlüsseltyp.

Die Kosten für den Test sind vernachlässigbar. Ein Prompt von etwa 10 Token und eine Antwort von 5 Token kosten 10 x $0,15 / 1M + 5 x $0,50 / 1M, also etwa $0,000004. Fehlgeschlagene oder abgelehnte Anfragen werden überhaupt nicht berechnet.

Prüfung 3: Der gleiche Test in Python

Wenn dein echter Code Python verwendet, teste ihn so, wie der Code ausgeführt wird. Dieses Skript nutzt das offizielle openai-Paket, also bedeutet ein Durchlauf hier, dass auch deine Anwendungskonfiguration funktioniert:

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)

Der with_raw_response-Wrapper gibt Zugriff auf die Header, während parse() das übliche Antwortobjekt zurückgibt. Die Python-Einrichtung wird in wie du einen LLM-Client in Python installierst behandelt, falls der Import fehlschlägt.

Prüfe dein Guthaben ohne Vervollständigung

Um das Guthaben ohne Textgenerierung zu lesen, rufe einen der Guthaben-Endpunkte auf. Es gibt einen OpenAI-kompatiblen und einen kurzen:

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 bereits das OpenAI-Guthabenformat erwarten, können den zweiten Pfad unverändert nutzen. Füge einen Aufruf wie diesen zu einem Überwachungsskript hinzu, und du erhältst eine Warnung, bevor ein Produktions-Bot leerläuft. Aufladungen beginnen bei $20 und Guthaben verfällt nie, also gibt es keinen Nachteil, wenn du eine komfortable Reserve hältst. Beträge und Boni findest du auf der Preisseite.

Mach den Test zu einem Gesundheitscheck

Sobald der Schlüssel funktioniert, behalte den Test. Ein kleines Skript, das zeitgesteuert läuft, informiert dich über eine fehlerhafte Bereitstellung, ein abgelaufenes Geheimnis oder ein niedriges Guthaben, bevor deine Nutzer es merken. Hier eine Node-Version mit dem eingebauten fetch (Node 18 oder neuer):

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

Das Skript endet mit einem Fehlercode, wenn der Aufruf fehlschlägt oder das Guthaben unter $5 fällt, sodass ein Cron-Job oder ein CI-Schritt dich warnen kann. Wähle den Schwellenwert basierend auf deiner eigenen Verbrauchsrate: Bei $2 pro Tag gibt dir $5 etwas mehr als zwei Tage Vorwarnzeit.

Was ein bestandener Test nicht beweist

Ein grüner Haken zeigt, dass Auth, Routing und das Modell in diesem Moment bei niedriger Last funktionieren. Er zeigt nicht, wie deine Anwendung sich bei 20 Nutzern gleichzeitig verhält. Dafür erinnere dich an die Limits: Ein Voll-Schlüssel führt 8 Anfragen gleichzeitig aus, und gestreamte Anfragen belegen ihren Slot bis zum Ende des Streams. Lasttest deinen eigenen Code mit einer Begrenzung paralleler Aufrufe vor dem Launch.

Fehler lesen

Was du siehst	Wahrscheinlichste Ursache	Was tun
Authentifizierungsfehler, oft 401	Falscher Schlüssel, zusätzlicher Leerraum, kein Bearer-Prefix	Kopiere den Schlüssel erneut, überprüfe den Header-String
404 oder HTML statt JSON	Falsche Basis-URL	Verwende exakt https://api.getaiapikey.com/v1
Modell nicht gefunden	Andere Modell-ID in der Anfrage	Stelle model auf uncensored
429 mit rate_limited oder concurrency	Zu viele Anfragen pro Minute oder gleichzeitig	Warte, dann wiederhole mit Verzögerung
429 mit Retry-After: 5	Vorübergehende Überlastung	Warte 5 Sekunden und versuche es erneut
Verbindungs- oder Timeout-Fehler	Netzwerk, Proxy oder Firewall	Teste von einem anderen Netzwerk, überprüfe Proxy-Variablen

Anfragen über 8 MB werden abgelehnt, also prüfe die Body-Größe, wenn nur große Aufrufe fehlschlagen. Die Dokumentation listet alle Fehlercodes und Header auf.

Gute Gewohnheiten im Umgang mit einem Schlüssel

• Bewahre den Schlüssel in einer Umgebungsvariable oder einem Secret-Store auf, niemals in Client-seitigem Code, einem öffentlichen Repository oder einem Screenshot.
• Verwende einen Schlüssel pro Anwendung, wo es möglich ist, damit ein Leak leicht nachverfolgt und ersetzt werden kann.
• Wenn ein Schlüssel möglicherweise geleakt wurde, ersetze ihn und prüfe dann das Guthaben auf unerwartete Ausgaben.
• Teile keinen Test-Schlüssel zwischen mehreren Programmen: Bei 2 parallelen Anfragen erreicht er schnell die Limits.

Wenn du nur sehen möchtest, ob eine kostenlose Option existiert, bevor du dich anmeldest, erklärt der Artikel über einen kostenlosen LLM-API-Schlüssel, was verfügbar ist. Andernfalls sind die drei oben genannten Prüfungen alles, was ein Schlüssel benötigt.

Weitere Anleitungen

• AI-API-Schlüssel-Preise: Was ein Schlüssel wirklich kostet
• AI-API-Checkliste