Schlüssel und API-Adresse
MarkdownWo Sie einen Schlüssel erhalten, welche Adresse Sie in den jeweiligen SDKs angeben und wie Sie den Schlüssel übermitteln.
Vollständiger Leitfaden
API-Schlüssel
Den Schlüssel erstellen Sie im Kundenbereich auf ailoot.ai nach der Registrierung. Er hat die Form sk-…. Sie können mehrere Schlüssel erstellen: getrennt für Arbeitsplatz, Server und jede Anwendung — so lässt sich einer leichter widerrufen, ohne die anderen zu beeinflussen.
Für einen Schlüssel lassen sich ein gesamtes Ausgabenlimit, eine Gültigkeitsdauer, Listen erlaubter und gesperrter IP-Adressen sowie Ausgabenlimits für Zeitfenster von 5 Stunden, 1 Tag und 7 Tagen festlegen. Greift eine Einschränkung, erhalten Sie einen verständlichen Fehler: api_key_quota_exhausted (Gesamtlimit aufgebraucht), usage_limit_reached (Ausgabenlimit des Schlüssels im Zeitfenster aufgebraucht — warten Sie auf ein neues Zeitfenster oder erhöhen Sie das Limit), api_key_expired oder permission_denied (zum Beispiel ein Request von einer nicht erlaubten IP-Adresse).
API-Adresse
Grundregel: Bei OpenAI-kompatiblen Clients die Adresse mit /v1, bei Anthropic und Gemini ohne diesen Zusatz.
| Client | Basisadresse | Ziel des Requests |
|---|---|---|
| OpenAI SDK und kompatible Clients | https://api.ailoot.ai/v1 | /v1/chat/completions, /v1/responses, /v1/embeddings |
| Anthropic SDK, Claude Code | https://api.ailoot.ai | /v1/messages |
| Google GenAI SDK, Gemini CLI | https://api.ailoot.ai | /v1beta/models/{model}:generateContent |
| Client verlangt vollständige Adresse | https://api.ailoot.ai/v1/chat/completions | wie angegeben |
Schlüssel übermitteln
Ailoot akzeptiert den Schlüssel in jedem der drei Header — verwenden Sie den, den Ihr SDK sendet:
| Header | Wer diesen Header sendet |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, die meisten Clients |
x-api-key: sk-… | Anthropic SDK, Claude Code mit ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Auf den Pfaden /v1/… wird ein Schlüssel in der Adresse (?key= oder ?api_key=) nicht akzeptiert: Der Request erhält 400 mit dem Code invalid_request und der Meldung, dass der Schlüssel in der Adresse übermittelt wurde. So gelangt der Schlüssel nicht in Logs und Browserverlauf. War er bereits in einer Adresse enthalten, erstellen Sie besser einen neuen.
Auf den Gemini-Pfaden /v1beta/… wird für die Kompatibilität mit Google ?key= akzeptiert — mit der niedrigsten Priorität nach den Headern. ?api_key= wird dort ebenfalls mit 400 abgelehnt. Zuverlässiger bleibt die Schlüsselübergabe im Header x-goog-api-key.
Umgebungsvariablen
Praktisch ist eine einzige Variable, die Sie in die Einstellungen verschiedener Anwendungen einsetzen:
# ~/.zshrc oder ~/.bashrc
export AILOOT_API_KEY="sk-..."
# für Programme, die die Standardnamen lesen
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"setx AILOOT_API_KEY "sk-..."
# für Programme, die die Standardnamen lesen
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# das Terminal neu starten, damit die Variablen übernommen werdenSchlüssel prüfen
Am günstigsten prüfen Sie den Schlüssel durch Abrufen der Modellliste: Das ist kostenlos.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"