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

# Eksportuj transkrypcję projektu

> Pobierz oryginalną lub przetłumaczoną transkrypcję projektu w formacie JSON, SRT lub VTT

# Eksportuj transkrypcję projektu

Pobierz transkrypcję z istniejącego projektu VoiceCheap bez użycia wewnętrznych punktów końcowych aplikacji internetowej. Punkt końcowy obsługuje transkrypcję źródłową oraz każdą dostępną transkrypcję w języku docelowym.
Pomyślne żądania zwracają HTTP `200`.

## Żądanie

**x-api-key** `string` *required*

Twój klucz API VoiceCheap.

**projectId** `string` *required*

Identyfikator projektu zwrócony przez [Utwórz projekt](https://api-docs.voicecheap.ai/docs/pl/api-reference/create-project.md) lub [Rozpocznij tłumaczenie](https://api-docs.voicecheap.ai/docs/pl/api-reference/translate.md).

**source** `string` *required*

`original` lub `translated`.

**targetLanguage** `string`

Wymagane, gdy `source` to `translated`. Użyj nazwy języka docelowego zapisanej w projekcie, takiej jak `french`.

**outputFormat** `string` (default: json)

`json`, `srt` lub `vtt`.

**includeSpeakerLabels** `boolean` (default: false)

Uwzględnij widoczne etykiety mówców w SRT lub VTT. JSON zawsze zawiera numery mówców.

## Przykłady

```bash cURL — Original JSON theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "original",
    "outputFormat": "json"
  }'
```

```bash cURL — Translated SRT theme={null}
curl -X POST "https://api.voicecheap.ai/v1/projects/project_123/transcript" \
  -H "x-api-key: vc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "translated",
    "targetLanguage": "french",
    "outputFormat": "srt",
    "includeSpeakerLabels": true
  }' \
  --output project_123-fr.srt
```

Odpowiedź JSON wykorzystuje tę samą znormalizowaną strukturę transkrypcji udokumentowaną w [Transkrybuj multimedia](https://api-docs.voicecheap.ai/docs/pl/api-reference/transcribe.md). Zapisane transkrypcje projektów zawierają znaczniki czasu segmentów, mówców, język, dane o pewności, gdy są dostępne, oraz `workId` dla przetłumaczonego wyniku.

## Tempo przetłumaczonych segmentów

**segments\[].finalSpeedFactor** `number`

Tylko przetłumaczone transkrypcje, gdy dla segmentu wygenerowano już głos. Stosunek czasu wygenerowanej mowy do okna segmentu, zmierzony przed końcowym dopasowaniem tempa i zaokrąglony do trzech miejsc po przecinku. `1` oznacza, że mowa mieści się naturalnie; wartości powyżej około `1.3` oznaczają, że audio trzeba było wyraźnie przyspieszyć, a wartości poniżej `0.9`, że je spowolniono.

Użyj go, aby dostroić [uruchomienie samego dubbingu](https://api-docs.voicecheap.ai/docs/pl/api-reference/translate.md#dub-only-mode-bring-your-own-translation): wyeksportuj przetłumaczoną transkrypcję jako JSON, skróć cue, których `finalSpeedFactor` jest zbyt wysoki, i wyślij poprawiony SRT do [Dubbing projektu](https://api-docs.voicecheap.ai/docs/pl/api-reference/dub-project.md). Wartość odzwierciedla ostatni głos wygenerowany dla segmentu i jest odświeżana przy każdym uruchomieniu.

## Błędy

| Status | Kod | Opis |
| - | - | - |
| 400 | `TARGET_LANGUAGE_REQUIRED` | Zażądano przetłumaczonego wyniku bez podania języka |
| 401 | `INVALID_API_KEY` | Klucz API jest brakujący lub nieprawidłowy |
| 403 | `FORBIDDEN` | Klucz API nie ma dostępu do tego projektu |
| 404 | `PROJECT_NOT_FOUND` | Projekt nie istnieje |
| 404 | `TRANSCRIPT_NOT_FOUND` | Żądany transkrypcja źródłowa lub przetłumaczona jest nieobecna |
| 409 | `TRANSCRIPT_NOT_READY` | Żądana transkrypcja jest w trakcie przetwarzania |


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