> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Uwierzytelnianie

> Uwierzytelniaj żądania API i klientów MCP za pomocą poświadczeń o ograniczonych uprawnieniach.

# Uwierzytelnianie

Przekaż klucz API w nagłówku `x-api-key` lub jako poświadczenie `Authorization: Bearer`. Zdalni klienci MCP mogą też logować się przez OAuth. Tokeny dostępu OAuth są ważne wyłącznie dla zasobu MCP; do wywołań REST używaj klucza API.

## Utwórz klucz o ograniczonych uprawnieniach

Otwórz [Integracje](https://app.voicecheap.ai/page-api), utwórz klucz i wybierz jego uprawnienia oraz opcjonalny termin wygaśnięcia. Pełny klucz zostanie wyświetlony tylko raz. Przechowuj go w magazynie sekretów. Później możesz zmienić jego nazwę, uprawnienia lub termin wygaśnięcia albo go unieważnić.

## Uprawnienia

Każda akcja określa wymagane uprawnienia w [katalogu akcji](https://api-docs.voicecheap.ai/docs/pl/api-reference/actions.md). Akcja może wymagać kilku uprawnień. Prawo do odczytu nie daje prawa do tworzenia, modyfikowania ani usuwania. Istniejące klucze bez jawnie określonych uprawnień zachowują jedynie wcześniejszy dostęp do projektów i transkrypcji; edytuj je lub zastąp nowymi, aby włączyć nowe funkcje.

| Obszar | Odczyt | Zapis lub usuwanie |
| - | - | - |
| Konto | `account:read` | — |
| Użycie | `usage:read` | — |
| Ustawienia | `settings:read` | `settings:write` |
| Zespół | `team:read` | `team:write` |
| Projekty | `projects:read` | `projects:write`, `projects:delete` |
| Tłumaczenie | — | `translations:write` |
| Transkrypcja | `transcription:read` | `transcription:write` |
| Napisy | `subtitles:read` | `subtitles:write` |
| Zamiana tekstu na mowę | `tts:read` | `tts:write` |
| Głosy | `voices:read` | `voices:write` |
| Obrazy | `images:read` | `images:write` |
| Miniatury | `thumbnails:read` | `thumbnails:write` |
| Foldery | `folders:read` | `folders:write` |
| Glosariusz | `glossary:read` | `glossary:write` |
| Webhooki | `webhooks:read` | `webhooks:write` |
| Publikowanie | `publishing:read` | `publishing:write` |

Uprawnienia ograniczają poświadczenie; nie zmieniają subskrypcji, roli w zespole, własności projektów ani dostępnych kredytów na media. Zmiany administracyjne w zespole pozostają zastrzeżone dla jego właściciela.

## Przykład nagłówka

To żądanie wykrywania wyświetla tylko akcje dozwolone dla Twojego klucza. Nie umieszczaj klucza API w kodzie przeglądarkowym ani w publicznym repozytorium.

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "x-api-key: vc_your-api-key"
```

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "Authorization: Bearer vc_your-api-key"
```

## Połączenia OAuth

W zgodnych asystentach użyj [zdalnego połączenia MCP](https://api-docs.voicecheap.ai/docs/pl/ai/model-context-protocol.md) i zaloguj się do VoiceCheap. Sprawdź uprawnienia na ekranie zgody. Każde połączenie możesz unieważnić w Integracjach bez usuwania kluczy API.

## Istniejące punkty końcowe REST

Istniejące ścieżki przesyłania plików, tłumaczenia, projektów i transkryptów nadal przyjmują klucze API i teraz egzekwują odpowiednie uprawnienia. Ich parametry znajdziesz w [dokumentacji API](https://api-docs.voicecheap.ai/docs/pl/api-reference/introduction.md), a zasady użycia na stronie [limitów](https://api-docs.voicecheap.ai/docs/pl/api-reference/limits.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.