Schlüssel und API-Adresse
MarkdownWo Sie einen Schlüssel erhalten, welche Adresse Sie in verschiedenen SDKs angeben und wie Sie den Schlüssel übermitteln.
Vollständiger Leitfaden
API-Schlüssel
Der Schlüssel wird im Kundenbereich auf ailoot.ai nach der Registrierung erstellt. Er sieht so aus: sk-…. Sie können mehrere Schlüssel erstellen: separat für Arbeitscomputer, Server und jede Anwendung — so lässt sich einer leichter widerrufen, ohne die übrigen zu beeinflussen.
Für einen Schlüssel können Sie ein gesamtes Ausgabenlimit, eine Gültigkeitsdauer, erlaubte und gesperrte 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 ausgeschöpft), usage_limit_reached (Ausgabenfenster des Schlüssels ausgeschöpft — warten Sie, bis es sich erneuert, oder erhöhen Sie das Limit), api_key_expired oder permission_denied (zum Beispiel Anfrage von einer nicht erlaubten IP-Adresse).
API-Adresse
Grundregel: Für OpenAI-kompatible Clients Adresse mit /v1, für Anthropic und Gemini ohne diesen Zusatz.
| Client | Basisadresse | Ziel der Anfrage |
|---|---|---|
| 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 sendet ihn so? |
|---|---|
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 URL (?key= oder ?api_key=) nicht akzeptiert: Die Anfrage erhält 400 mit dem Code invalid_request und dem Hinweis, dass der Schlüssel in der URL übergeben wurde. So landet der Schlüssel nicht in Protokollen oder im Browserverlauf. War er bereits in einer URL enthalten, erstellen Sie besser einen neuen.
Auf den Gemini-Pfaden /v1beta/… wird für die Google-Kompatibilität ?key= akzeptiert — mit der niedrigsten Priorität, nach den Headern. ?api_key= wird auch dort mit 400 abgelehnt. Zuverlässiger ist weiterhin die Schlüsselübergabe im Header x-goog-api-key.
Umgebungsvariablen
Praktisch ist eine einzige Variable, die Sie in verschiedenen Programmeinstellungen 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
Die günstigste Schlüsselprüfung ist der Abruf der Modellliste: Er ist kostenlos.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"