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

# Exporter la transcription du projet

> Récupérer une transcription de projet originale ou traduite au format JSON, SRT ou VTT

# Exporter la transcription du projet

Récupérer une transcription à partir d'un projet VoiceCheap existant sans utiliser les points de terminaison de l'application web interne. Le point de terminaison prend en charge la transcription source et chaque transcription en langue cible disponible.
Les requêtes réussies renvoient le code HTTP `200`.

## Requête

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

Votre clé API VoiceCheap.

**projectId** `string` *required*

Identifiant de projet renvoyé par [Créer un projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/create-project.md) ou [Démarrer la traduction](https://api-docs.voicecheap.ai/docs/fr/api-reference/translate.md).

**source** `string` *required*

`original` ou `translated`.

**targetLanguage** `string`

Requis lorsque `source` est `translated`. Utilisez le nom de la langue cible stocké sur le projet, tel que `french`.

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

`json`, `srt` ou `vtt`.

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

Inclure les étiquettes de locuteur visibles dans le fichier SRT ou VTT. Le format JSON inclut toujours les numéros de locuteur.

## Exemples

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

La réponse JSON utilise la même structure de transcription normalisée documentée dans [Transcrire un média](https://api-docs.voicecheap.ai/docs/fr/api-reference/transcribe.md). Les transcriptions de projet stockées incluent les horodatages des segments, les locuteurs, la langue, les données de confiance lorsqu'elles sont disponibles, et un `workId` pour la sortie traduite.

## Rythme des segments traduits

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

Transcriptions traduites uniquement, une fois qu'une voix a été générée pour le segment. Rapport entre la durée de la voix générée et la fenêtre du segment, mesuré avant l'ajustement final du tempo et arrondi à trois décimales. `1` signifie que la voix tient naturellement ; des valeurs au-dessus d'environ `1.3` signifient que l'audio a dû être nettement accéléré, des valeurs sous `0.9` qu'il a été ralenti.

Utilisez-le pour ajuster une [exécution en doublage seul](https://api-docs.voicecheap.ai/docs/fr/api-reference/translate.md#dub-only-mode-bring-your-own-translation) : exportez la transcription traduite en JSON, raccourcissez les répliques dont le `finalSpeedFactor` est trop élevé, puis envoyez le SRT révisé à [Doubler le projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/dub-project.md). La valeur reflète la dernière voix générée pour le segment et elle est donc actualisée à chaque exécution.

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 400 | `TARGET_LANGUAGE_REQUIRED` | La sortie traduite a été demandée sans langue |
| 401 | `INVALID_API_KEY` | La clé API est manquante ou invalide |
| 403 | `FORBIDDEN` | La clé API ne peut pas accéder à ce projet |
| 404 | `PROJECT_NOT_FOUND` | Le projet n'existe pas |
| 404 | `TRANSCRIPT_NOT_FOUND` | La transcription source ou traduite demandée est absente |
| 409 | `TRANSCRIPT_NOT_READY` | La transcription demandée est en cours de traitement |


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