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

<ParamField header="x-api-key" type="string" required>
  Ihr VoiceCheap API-Schlüssel.
</ParamField>

<ParamField path="projectId" type="string" required>
  Projektkennung, die von [Projekt erstellen](/docs/de/api-reference/create-project) oder [Übersetzung starten](/docs/de/api-reference/translate) zurückgegeben wird.
</ParamField>

<ParamField body="source" type="string" required>
  `original` oder `translated`.
</ParamField>

<ParamField body="targetLanguage" type="string">
  Erforderlich, wenn `source` gleich `translated` ist. Verwenden Sie den Namen der Zielsprache, der im Projekt gespeichert ist, wie z. B. `french`.
</ParamField>

<ParamField body="outputFormat" type="string" default="json">
  `json`, `srt` oder `vtt`.
</ParamField>

<ParamField body="includeSpeakerLabels" type="boolean" default="false">
  Sichtbare Sprecher-Labels in SRT oder VTT einfügen. JSON enthält immer Sprechernummern.
</ParamField>

## 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](/docs/de/api-reference/transcribe) dokumentiert ist. Gespeicherte Projekttranskripte enthalten Segment-Zeitstempel, Sprecher, Sprache, Konfidenzdaten, falls verfügbar, und eine `workId` für die übersetzte Ausgabe.

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