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

# Obtenir les détails du projet

> Récupérer les détails publics du projet, l'historique des versions traduites et l'historique de synchronisation labiale

# Obtenir les détails du projet

Récupérer une vue publique normalisée d'un projet. Utilisez ce point de terminaison lorsque vous avez besoin de l'historique des versions traduites, de l'historique de synchronisation labiale, de l'état des sous-titres dynamiques ou de l'état de publication.

Pour un interrogatoire fréquent, continuez à utiliser [Obtenir le statut de traduction](https://api-docs.voicecheap.ai/docs/fr/api-reference/translation-status.md). Ce point de terminaison est plus riche et renvoie intentionnellement plus de données.

## Requête

### En-têtes

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

Votre clé API VoiceCheap. Obtenez-en une sur [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Paramètres de chemin

**projectId** `string` *required*

L'identifiant unique du 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).

## Réponse

**projectId** `string` *required*

L'identifiant unique du projet.

**projectName** `string` *required*

Le nom du projet.

**status** `string` *required*

Statut public du projet : `processing`, `success` ou `failed`.

**workflow** `string` *required*

Flux de travail API : `translation` ou `transcription`. Les flux de travail de transcription atteignent le succès lorsque la transcription source est terminée.

**originalVideoUrl** `string` *required*

URL vers le fichier vidéo ou audio original téléchargé.

**originalLanguage** `string` *required*

La langue originale détectée ou spécifiée.

**targetLanguages** `string[]` *required*

Langues cibles associées au projet.

**duration** `number` *required*

Durée du contenu en secondes.

**createdAt** `number` *required*

Horodatage Unix de création du projet.

**progress** `object` *required*

Progression actuelle au niveau du projet.

**propriétés de progression**

**progress.step** `string`

Étape actuelle de création ou de transcription du projet.

**progress.transcriptionProgress** `number`

Pourcentage approximatif de progression de la création/transcription du projet.

**progress.transcriptionStatus** `string` *required*

Statut de la transcription source : `processing`, `success` ou `failed`.

**translations** `array` *required*

Historique des versions traduites, trié avec la version la plus récente en premier.

**propriétés de traduction**

**translations\[].workId** `string`

Identifiant du travail de traduction.

**translations\[].translatedVersionId** `string`

Identifiant de la version traduite.

**translations\[].targetLanguage** `string`

Langue cible pour cette version.

**translations\[].status** `string`

Statut de la version de traduction : `in-progress`, `completed`, `not-started` ou `failed`.

**translations\[].currentStep** `string`

Étape actuelle de doublage pour cette version.

**translations\[].progress** `number`

Pourcentage approximatif de progression du doublage.

**translations\[].createdAt** `number`

Horodatage de création de cette version traduite.

**translations\[].completedAt** `number`

Horodatage d'achèvement lorsqu'il est disponible.

**translations\[].failedAt** `number`

Horodatage d'échec lorsqu'il est disponible.

**translations\[].timedOutAt** `number`

Horodatage de délai d'attente lorsqu'il est disponible.

**translations\[].translatedVideoUrl** `string`

URL de la vidéo traduite.

**translations\[].translatedAudioUrl** `string`

URL de l'audio traduit.

**translations\[].settings** `object`

Paramètres publics utilisés pour la version traduite, tels que les sous-titres, SmartSync, l'audio d’arrière-plan et le mode de qualité.

**translations\[].settings.dubbingMode** `string`

`translate` lorsque VoiceCheap a traduit la transcription avec son moteur de traduction et SmartSync, `dub-only` lorsque le texte provient d'un `translatedSrt` que vous avez fourni (voir [Doubler le projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/dub-project.md)). Les versions en doublage seul indiquent toujours `smartSync: false`.

**translations\[].error** `object`

Code d'erreur et message en cas d'échec de la version traduite.

**translations\[].lipSync** `object`

Historique de la synchronisation labiale pour la version traduite, présent uniquement lorsque la synchronisation labiale a été demandée.

**Propriétés de synchronisation labiale**

**translations\[].lipSync.latest** `object`

Dernière tentative de synchronisation labiale.

**translations\[].lipSync.history** `array`

Toutes les tentatives de synchronisation labiale pour cette version traduite, par ordre de création.

**translations\[].lipSync.history\[].jobId** `string`

Identifiant de la tâche de synchronisation labiale.

**translations\[].lipSync.history\[].status** `string`

Statut de la synchronisation labiale : `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `REJECTED` ou `CANCELED`.

**translations\[].lipSync.history\[].videoUrl** `string`

URL de la vidéo avec synchronisation labiale une fois terminée.

**translations\[].lipSync.history\[].type** `string`

Mode de synchronisation labiale : `standard`, `pro` ou `studio`.

**translations\[].lipSync.history\[].activeSpeakerDetectionEnabled** `boolean`

Indique si la détection du locuteur actif était activée pour cette tentative.

**translations\[].dynamicSubtitles** `object`

État des sous-titres dynamiques lorsqu'ils sont disponibles.

**translations\[].publicationAttempts** `array`

État de la tentative de publication publique lorsqu'il est disponible.

**translations\[].publishedVideos** `array`

Références de la vidéo publiée publiquement lorsqu'elles sont disponibles.

## Exemple

```bash cURL theme={null}
curl -X GET "https://api.voicecheap.ai/v1/projects/abc123-def456-ghi789" \
  -H "x-api-key: vc_your-api-key"
```

```json Response theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "Launch Demo",
  "status": "success",
  "workflow": "translation",
  "originalVideoUrl": "https://storage.example.com/input.mp4",
  "originalLanguage": "en",
  "targetLanguages": ["french"],
  "duration": 120,
  "createdAt": 1791280000000,
  "progress": {
    "step": "done",
    "transcriptionProgress": 100,
    "transcriptionStatus": "success"
  },
  "translations": [
    {
      "workId": "work_123",
      "translatedVersionId": "version_456",
      "targetLanguage": "french",
      "status": "completed",
      "currentStep": "done",
      "progress": 100,
      "createdAt": 1791280200000,
      "completedAt": 1791280800000,
      "translatedVideoUrl": "https://storage.example.com/translated.mp4",
      "translatedAudioUrl": "https://storage.example.com/translated.mp3",
      "settings": {
        "voiceCloning": true,
        "uploadType": "video",
        "keepBackgroundMusic": true,
        "keepOriginalVoice": false,
        "originalVoiceVolume": 30,
        "subtitles": {
          "isEnable": true,
          "source": "translated"
        },
        "smartSync": true,
        "dubbingMode": "translate",
        "voiceIsolatorOption": "realistic",
        "translationQualityMode": "max"
      },
      "lipSync": {
        "latest": {
          "jobId": "lip_789",
          "status": "COMPLETED",
          "videoUrl": "https://storage.example.com/lipsync.mp4",
          "errorMessage": null,
          "type": "pro",
          "createdAt": "2026-06-08T10:00:00.000Z",
          "completedAt": "2026-06-08T10:20:00.000Z",
          "activeSpeakerDetectionEnabled": true
        },
        "history": [
          {
            "jobId": "lip_789",
            "status": "COMPLETED",
            "videoUrl": "https://storage.example.com/lipsync.mp4",
            "errorMessage": null,
            "type": "pro",
            "createdAt": "2026-06-08T10:00:00.000Z",
            "completedAt": "2026-06-08T10:20:00.000Z",
            "activeSpeakerDetectionEnabled": true
          }
        ]
      }
    }
  ]
}
```

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 401 | `MISSING_API_KEY` | La clé API est requise |
| 401 | `INVALID_API_KEY` | La clé API fournie est invalide |
| 403 | `FORBIDDEN` | Vous n'avez pas l'autorisation d'accéder au projet |
| 404 | `PROJECT_NOT_FOUND` | Le projet n'existe pas |
| 429 | `RATE_LIMIT_EXCEEDED` | Trop de requêtes |
| 500 | `INTERNAL_ERROR` | Erreur serveur inattendue |


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