API-Schlüssel und API-Adresse

Sie erstellen den Schlüssel im Kundenbereich auf ailoot.ai nach der Registrierung. Er hat das Format sk-…. Sie können mehrere Schlüssel erstellen: getrennt für den Arbeitscomputer, den Server und jede Anwendung — so lässt sich ein Schlüssel leichter widerrufen, ohne die anderen zu ändern.

Für einen Schlüssel lassen sich ein Gesamtausgabenlimit, eine Gültigkeitsdauer, IP-Zulassungs- und Sperrlisten sowie Ausgabenlimits für Zeitfenster von 5 Stunden, 1 Tag und 7 Tagen festlegen. Wenn eine Einschränkung greift, erhalten Sie einen verständlichen Fehler: api_key_quota_exhausted (Gesamtlimit ausgeschöpft), usage_limit_reached (Ausgabenlimit des Schlüssels für dieses Zeitfenster ausgeschöpft — warten Sie, bis das Zeitfenster erneuert wird, oder erhöhen Sie das Limit), api_key_expired oder permission_denied (zum Beispiel eine Anfrage von einer nicht zugelassenen IP).

Grundregel: Für OpenAI-kompatible Clients die Adresse mit /v1, für Anthropic und Gemini ohne diesen Zusatz.

Ailoot akzeptiert den Schlüssel in jedem der drei Header — der von Ihrem SDK verwendete Header ist geeignet:

Auf den Pfaden /v1/… wird ein Schlüssel in der Adresse (?key= oder ?api_key=) nicht akzeptiert: Die Anfrage 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 oder den Browserverlauf. Wenn der Schlüssel bereits in einer Adresse verwendet wurde, erstellen Sie besser einen neuen.

Auf den Gemini-Pfaden /v1beta/… wird zur Kompatibilität mit Google ?key= akzeptiert — mit der niedrigsten Priorität, nach den Headern. ?api_key= wird dort ebenfalls mit 400 abgelehnt. Zuverlässiger ist weiterhin die Übermittlung des Schlüssels im Header x-goog-api-key.

Es ist praktisch, eine einzige Variable anzulegen und sie in die Einstellungen verschiedener Programme einzusetzen:

# ~/.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-..."
# Starten Sie das Terminal neu, damit die Umgebungsvariablen übernommen werden

Der günstigste Weg, den Schlüssel zu prüfen, ist die Abfrage der Modellliste: Sie ist kostenlos.

curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"