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

<ParamField header="x-api-key" type="string" required>
  Votre clé API VoiceCheap.
</ParamField>

<ParamField path="projectId" type="string" required>
  Identifiant de projet renvoyé par [Créer un projet](/docs/fr/api-reference/create-project) ou [Démarrer la traduction](/docs/fr/api-reference/translate).
</ParamField>

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

<ParamField body="targetLanguage" type="string">
  Requis lorsque `source` est `translated`. Utilisez le nom de la langue cible stocké sur le projet, tel que `french`.
</ParamField>

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

<ParamField body="includeSpeakerLabels" type="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.
</ParamField>

## 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](/docs/fr/api-reference/transcribe). 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.

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