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

# Projekttranskript exportieren

> Rufen Sie ein ursprüngliches oder übersetztes Projekttranskript als JSON, SRT oder VTT ab

# Projekttranskript exportieren

Rufen Sie ein Transkript aus einem bestehenden VoiceCheap-Projekt ab, ohne interne Web-App-Endpunkte zu verwenden. Der Endpunkt unterstützt das Quelltranskript und jedes verfügbare Transkript in der Zielsprache.
Erfolgreiche Anfragen geben HTTP `200` zurück.

## Anfrage

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

Ihr VoiceCheap API-Schlüssel.

**projectId** `string` *required*

Projektkennung, die von [Projekt erstellen](https://api-docs.voicecheap.ai/docs/de/api-reference/create-project.md) oder [Übersetzung starten](https://api-docs.voicecheap.ai/docs/de/api-reference/translate.md) zurückgegeben wird.

**source** `string` *required*

`original` oder `translated`.

**targetLanguage** `string`

Erforderlich, wenn `source` gleich `translated` ist. Verwenden Sie den Namen der Zielsprache, der im Projekt gespeichert ist, wie z. B. `french`.

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

`json`, `srt` oder `vtt`.

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

Sichtbare Sprecher-Labels in SRT oder VTT einfügen. JSON enthält immer Sprechernummern.

## Beispiele

```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
```

Die JSON-Antwort verwendet dieselbe normalisierte Transkriptstruktur, die in [Medien transkribieren](https://api-docs.voicecheap.ai/docs/de/api-reference/transcribe.md) dokumentiert ist. Gespeicherte Projekttranskripte enthalten Segment-Zeitstempel, Sprecher, Sprache, Konfidenzdaten, falls verfügbar, und eine `workId` für die übersetzte Ausgabe.

## Tempo übersetzter Segmente

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

Nur übersetzte Transkripte, sobald für das Segment eine Stimme erzeugt wurde. Verhältnis zwischen der Dauer der erzeugten Sprache und dem Segmentfenster, gemessen vor der letzten Tempopassung und auf drei Dezimalstellen gerundet. `1` bedeutet, dass die Sprache natürlich passt; Werte über ungefähr `1.3` bedeuten, dass das Audio spürbar beschleunigt werden musste, Werte unter `0.9` bedeuten, dass es verlangsamt wurde.

Nutzen Sie ihn, um einen [Nur-Synchronisationslauf](https://api-docs.voicecheap.ai/docs/de/api-reference/translate.md#dub-only-mode-bring-your-own-translation) abzustimmen: exportieren Sie das übersetzte Transkript als JSON, kürzen Sie die Cues, deren `finalSpeedFactor` zu hoch ist, und senden Sie das überarbeitete SRT an [Projekt synchronisieren](https://api-docs.voicecheap.ai/docs/de/api-reference/dub-project.md). Der Wert entspricht der zuletzt für das Segment erzeugten Stimme und wird bei jedem Lauf aktualisiert.

## Fehler

| Status | Code | Beschreibung |
| - | - | - |
| 400 | `TARGET_LANGUAGE_REQUIRED` | Übersetzte Ausgabe wurde ohne Sprache angefordert |
| 401 | `INVALID_API_KEY` | API-Schlüssel fehlt oder ist ungültig |
| 403 | `FORBIDDEN` | API-Schlüssel kann nicht auf dieses Projekt zugreifen |
| 404 | `PROJECT_NOT_FOUND` | Projekt existiert nicht |
| 404 | `TRANSCRIPT_NOT_FOUND` | Angefordertes Quell- oder übersetztes Transkript fehlt |
| 409 | `TRANSCRIPT_NOT_READY` | Angefordertes Transkript wird noch verarbeitet |


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