> ## 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.

# Dokumentacja API

> Pełna dokumentacja REST API VoiceCheap

# Dokumentacja API

API VoiceCheap korzysta ze standardowych metod i kodów stanu HTTP. Większość punktów końcowych zwraca JSON, a eksport transkrypcji może zwracać także SRT lub VTT.

Do ustawień konta, zarządzania zespołem, narzędzi multimedialnych i innych procesów używaj [katalogu akcji](https://api-docs.voicecheap.ai/docs/pl/api-reference/actions.md). Te procesy są również dostępne przez [serwer MCP konta](https://api-docs.voicecheap.ai/docs/pl/ai/model-context-protocol.md), z wyjątkiem tworzenia i rotacji sekretu podpisywania webhooków, które wymagają REST. Zarządzaj poświadczeniami w [Integracjach](https://api-docs.voicecheap.ai/docs/pl/ai/integrations.md) i sprawdź [limity użycia](https://api-docs.voicecheap.ai/docs/pl/api-reference/limits.md).

## Podstawowy adres URL

Wszystkie żądania API należy kierować na adres:

```text theme={null}
https://api.voicecheap.ai
```

## Uwierzytelnianie

Uwierzytelniaj prywatne wywołania REST kluczem API w `x-api-key` lub `Authorization: Bearer`. Dokument OpenAPI jest publiczny. Informacje o poświadczeniach o ograniczonych uprawnieniach i OAuth dla MCP znajdziesz na stronie [Uwierzytelnianie](https://api-docs.voicecheap.ai/docs/pl/authentication.md).

## API akcji JSON

Sekcje konta, zespołu, projektów, głosów i narzędzi multimedialnych opisują każdą akcję JSON osobno. Wszystkie te ścieżki używają `POST`, także do odczytu i usuwania; argumenty wysyłaj w treści JSON. Poniższe ścieżki przesyłania plików i istniejących projektów zachowują własne metody HTTP.

Utwórz klucz API z uprawnieniem `account:read`, ustaw zmienną środowiskową `VOICECHEAP_API_KEY` i wypróbuj to żądanie tylko do odczytu:

```bash theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/account_get' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'
```

Zakończona akcja zwraca HTTP 200 z wynikiem w `data`. Dłuższa akcja zwraca HTTP 202 i `requestId`; odczytaj [stan żądania](https://api-docs.voicecheap.ai/docs/pl/api-reference/actions/requests/action-request-get.md), aby odzyskać wynik. Zadanie multimedialne może trwać po zakończeniu żądania akcji.

Przejrzyj [wszystkie akcje według obszaru](https://api-docs.voicecheap.ai/docs/pl/api-reference/actions.md) lub [sprawdź akcje i schematy dostępne dla Twojego klucza](https://api-docs.voicecheap.ai/docs/pl/api-reference/discovery/actions-list.md). Każda strona podaje uprawnienia, parametry, przykłady i błędy.

## Typy zawartości

* **Żądanie**: Użyj `multipart/form-data` do przesyłania plików, `application/json` dla pozostałych żądań
* **Odpowiedź**: Punkty końcowe JSON zwracają `application/json`. Eksporty transkrypcji mogą również zwracać tekst w formacie SRT lub VTT.

## Przesyłanie plików i istniejące ścieżki projektów

> [card] [Transkrypcja mediów](https://api-docs.voicecheap.ai/docs/pl/api-reference/transcribe.md)
>
> `POST /v1/transcribe`
>
> Transkrybuj przesłany plik do formatu JSON, SRT lub VTT.

> [card] [Eksport transkrypcji projektu](https://api-docs.voicecheap.ai/docs/pl/api-reference/project-transcript.md)
>
> `POST /v1/projects/{projectId}/transcript`
>
> Pobierz oryginalne lub przetłumaczone transkrypcje projektu.

> [card] [Utwórz projekt](https://api-docs.voicecheap.ai/docs/pl/api-reference/create-project.md)
>
> `POST /v1/projects`
>
> Prześlij plik wideo lub audio i rozpocznij samą transkrypcję.

> [card] [Rozpocznij tłumaczenie](https://api-docs.voicecheap.ai/docs/pl/api-reference/translate.md)
>
> `POST /v1/translate`
>
> Prześlij plik wideo lub audio i rozpocznij projekt tłumaczeniowy.

> [card] [Zdubbinguj projekt](https://api-docs.voicecheap.ai/docs/pl/api-reference/dub-project.md)
>
> `POST /v1/projects/{projectId}/dub`
>
> Zdubbinguj projekt z gotową transkrypcją na podstawie własnego przetłumaczonego pliku SRT.

> [card] [Pobierz status tłumaczenia](https://api-docs.voicecheap.ai/docs/pl/api-reference/translation-status.md)
>
> `GET /v1/translate/{projectId}/status`
>
> Sprawdź status projektu tłumaczeniowego i pobierz wyniki.

> [card] [Pobierz szczegóły projektu](https://api-docs.voicecheap.ai/docs/pl/api-reference/project-details.md)
>
> `GET /v1/projects/{projectId}`
>
> Pobierz historię przetłumaczonych wersji, historię synchronizacji ruchu ust oraz stan projektu.

> [card] [Usuń projekt](https://api-docs.voicecheap.ai/docs/pl/api-reference/delete-project.md)
>
> `DELETE /v1/translate/{projectId}`
>
> Trwale usuń projekt tłumaczeniowy oraz powiązane z nim zasoby.

## Przepływ pracy tłumaczenia

Typowy przepływ pracy przy tłumaczeniu wideo wygląda następująco:

```mermaid theme={null}
sequenceDiagram
    participant Client as Klient
    participant API
    participant Processing as Przetwarzanie

    Client->>API: POST /v1/translate (plik + opcje)
    API->>Processing: Dodaj tłumaczenie do kolejki
    API-->>Client: 201 (projectId)

    loop Sprawdź status
        Client->>API: GET /v1/translate/{projectId}/status
        API-->>Client: status (processing/success/failed)
    end

    Note over Client: Pobierz adres URL przetłumaczonego wideo, gdy status to "success"
```

## Format odpowiedzi

Poniższe istniejące ścieżki plików i projektów zachowują własne formaty odpowiedzi.

Pola poprawnej odpowiedzi zależą od punktu końcowego. Utworzenie projektu i rozpoczęcie dubbingu zwracają `success`, `message` i `projectId`. Zapytania o status i szczegóły zwracają stan projektu, a żądania transkrypcji zwracają JSON, SRT lub VTT. Dokładne pola opisano na stronie każdego punktu końcowego.

Błędy zwracają obiekt JSON z `code` i `message`, czasem również z `details`. Zobacz [Kody błędów](https://api-docs.voicecheap.ai/docs/pl/api-reference/errors.md).

## Kody stanu HTTP

| Kod stanu | Opis |
| - | - |
| 200 | Sukces |
| 201 | Utworzono – Uruchomiono projekt lub dubbing |
| 202 | Przyjęto - Śledź akcję asynchroniczną za pomocą identyfikatora żądania |
| 400 | Błędne żądanie - Nieprawidłowe parametry |
| 401 | Brak autoryzacji - Nieprawidłowy lub brakujący klucz API |
| 403 | Zabronione - Niewystarczające uprawnienia lub kredyty |
| 404 | Nie znaleziono - Zasób nie istnieje |
| 409 | Konflikt – Stan projektu nie pozwala na wykonanie żądania |
| 413 | Plik za duży – Przesłany plik przekracza limit |
| 429 | Zbyt wiele żądań - Przekroczono limit szybkości |
| 500 | Wewnętrzny błąd serwera |
| 502 | Błąd przetwarzania – Nie udało się ukończyć transkrypcji |
| 503 | Usługa tymczasowo niedostępna - Zachowaj identyfikator i sprawdź stan przed ponowną próbą |


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