# API-Schlüssel

Um [unsere API zu nutzen](/docs/api), müssen Sie [einen API-Schlüssel erstellen](/keys/api).

Sobald Sie Ihren Schlüssel haben, können Sie ihn verwenden, um Ihre Anfragen an unsere API zu authentifizieren.

Mit [`curl`](https://curl.se) können Sie Ihren API-Schlüssel beispielsweise wie folgt verwenden:

```bash
export AISH_API_KEY="sk_..."

curl -X 'GET' 'https://api.aish.li/v1/ai/agents?limit=3' \
  -H "X-API-Key: $AISH_API_KEY" \
  | jq .
```

Ein ähnlicher Befehl wird auch angezeigt, nachdem Sie in der [API-Referenz](/docs/api) auf _Try it out_ und _Execute_ klicken.

Beachten Sie, dass sich dieser `X-API-Key`-Header vom Header `Authorization: Bearer ...` unterscheidet, der ausschließlich für die OAuth2-Token-Authentifizierung in der interaktiven API-Dokumentation verwendet wird. Der Header `X-API-Key` wird anstelle von OAuth2 für die API-Schlüssel-Authentifizierung von Ihren eigenen Backend-Systemen aus verwendet.

> [!CAUTION]
> Ihre API-Schlüssel sind vertraulich und gewähren vollen Zugriff auf Ihr Konto, ohne dass Ihr Anmeldepasswort erforderlich ist – einschließlich Ihrer Agenten, Ihres Sitzungsverlaufs und Ihrer Einstellungen.
>
> - Teilen Sie Ihren API-Schlüssel niemals öffentlich und committen Sie ihn nicht in Git-Repositories.
> - Betten Sie API-Schlüssel niemals in clientseitiges HTML oder JavaScript ein.
> - Wenn Sie vermuten, dass ein Schlüssel kompromittiert wurde, widerrufen Sie ihn sofort über das Papierkorb-Symbol auf der Seite [API-Schlüssel](/keys/api).

API-Schlüssel werden bei der Erstellung nur ein einziges Mal angezeigt. Wenn Sie einen Schlüssel verlieren, müssen Sie einen neuen erstellen.