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

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

# Schlüssel und API-Adresse

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

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

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

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

Veröffentlichen Sie den Schlüssel weder in Code noch in Repositories oder Screenshots. Speichern Sie ihn in einer Umgebungsvariablen oder einem Geheimnismanager. Wurde er offengelegt, löschen Sie ihn im Kundenbereich und erstellen Sie einen neuen.

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

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

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

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

Praktisch ist eine einzige Variable, die Sie in die Einstellungen verschiedener Anwendungen 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-at/keys/#check)Schlüssel prüfen

Am günstigsten prüfen Sie den Schlüssel durch Abrufen der Modellliste: Das ist kostenlos.

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

Noch Fragen? Senden 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.