> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Uwierzytelnianie API

## Klucze API

> **Tip**
>
> Pomiń klucz. Niech skonfiguruje go twój agent programistyczny.
>
> Wklej to do Claude Code, Cursor lub Codex. Narzędzie zaloguje cię lub utworzy konto, utworzy klucz i doda SDK do projektu.
>
> ```text
> Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.
> ```
>
> [Zobacz, jak to działa](/docs/pl/eleven-api/quickstart#set-up-with-your-coding-agent) lub przeczytaj [kod źródłowy polecenia `onboard`](https://github.com/elevenlabs/cli/tree/main/cli/elevenlabs/workflow/onboard), aby dokładnie zobaczyć, co przekazuje twojemu agentowi.

API ElevenLabs używa kluczy API do uwierzytelniania. Każde żądanie do API musi zawierać klucz API, który uwierzytelnia żądania i śledzi limit użycia.

Dla każdego klucza API możesz ustawić te ograniczenia:

1. **Ograniczenie zakresu:** Ogranicz dostęp, wskazując endpointy API dostępne dla klucza.
2. **Limit kredytów:** Ustaw własne limity kredytów, by kontrolować użycie.
3. **Lista dozwolonych adresów IP:** Ogranicz klucz do konkretnych adresów IP lub zakresów CIDR. Żądania z adresów IP spoza listy są odrzucane z błędem `403`. [Dowiedz się więcej](/docs/pl/overview/administration/workspaces/api-keys#ip-allowlisting).

**Pamiętaj, że klucz API jest tajny.** Nie udostępniaj go innym ani nie ujawniaj w kodzie po stronie klienta (przeglądarki, aplikacje).

Wszystkie żądania do API powinny zawierać klucz API w nagłówku HTTP `xi-api-key`:

```bash
xi-api-key: ELEVENLABS_API_KEY
```

### Wysyłanie żądań

Możesz wkleić poniższe polecenie do terminala, aby wykonać pierwsze żądanie do API. Zastąp `$ELEVENLABS_API_KEY` swoim tajnym kluczem API.

```bash
curl 'https://api.elevenlabs.io/v1/models' \
  -H 'Content-Type: application/json' \
  -H 'xi-api-key: $ELEVENLABS_API_KEY'
```

Przykład z pakietem Python `elevenlabs`:

```python
from elevenlabs.client import ElevenLabs

elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)
```

Przykład z pakietem Node.js `elevenlabs`:

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});
```

### Tokeny jednorazowe

W przypadku niektórych endpointów możesz użyć tokenów jednorazowych do uwierzytelniania żądań. Są ważne przez ograniczony czas i pozwalają łączyć się z API bez ujawniania klucza API, na przykład po stronie klienta.

Więcej informacji znajdziesz w dokumentacji [Tokeny jednorazowe](/docs/pl/api-reference/tokens/create).