Source: https://ailoot.ai/docs/de-ch/keys/
Canonical: https://ailoot.ai/docs/de-ch/keys/
Language: de-ch

[Einstieg](https://ailoot.ai/docs/de-ch/) 

# Schlüssel und API-Adresse

[Markdown](https://ailoot.ai/docs/de-ch/keys/index.md)

Wo Sie einen Schlüssel erhalten, welche Adresse Sie in verschiedenen SDKs angeben und wie Sie den Schlüssel übermitteln.

## [](https://ailoot.ai/docs/de-ch/keys/#key)API-Schlüssel

Der Schlüssel wird im Kundenbereich auf [ailoot.ai](https://ailoot.ai) nach der [Registrierung](https://ailoot.ai/register) 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).

Veröffentlichen Sie den Schlüssel nicht in Code, Repositorys oder Screenshots. Speichern Sie ihn in einer Umgebungsvariablen oder einem Secret-Manager. Wurde er offengelegt, löschen Sie ihn im Kundenbereich und erstellen Sie einen neuen.

## [](https://ailoot.ai/docs/de-ch/keys/#base-url)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 |

404 direkt nach der Einrichtung? Fast immer liegt es an der Adresse: überflüssiges oder fehlendes `/v1`, doppelter Schrägstrich oder `/chat/completions` an einer Stelle, an der der Client dies selbst ergänzt.

## [](https://ailoot.ai/docs/de-ch/keys/#auth)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`.

## [](https://ailoot.ai/docs/de-ch/keys/#env)Umgebungsvariablen

Praktisch ist eine einzige Variable, die Sie in verschiedenen Programmeinstellungen einsetzen:

```bash
# ~/.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"
```

```powershell
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 werden
```

## [](https://ailoot.ai/docs/de-ch/keys/#check)Schlüssel prüfen

Die günstigste Schlüsselprüfung ist der Abruf der Modellliste: Er ist kostenlos.

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

Noch Fragen? Schicken Sie uns die Request ID und eine Beschreibung — wir helfen Ihnen weiter.[Support kontaktieren](mailto:support@ailoot.ai)

## Ailoot · Das Unternehmen und sein Projektportfolio





Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.





Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.





Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.