> ## 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 le statut de la traduction

> Vérifiez le statut d'un projet de traduction et récupérez les résultats

# Obtenir le statut de la traduction

Récupérez le statut actuel d'un projet de traduction. Utilisez ce point de terminaison pour interroger la progression et obtenir l'URL de la vidéo traduite une fois le traitement terminé.

## 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 de traduction renvoyé par le point de terminaison [Start Translation](https://api-docs.voicecheap.ai/docs/fr/api-reference/translate.md).

> [!NOTE]
>
> Un projet créé avec [Créer un projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/create-project.md) passe au flux `translation` dès que [Doubler le projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/dub-project.md) est appelé : ce point de terminaison suit alors la dernière exécution de doublage.

## Réponse

La structure de la réponse varie en fonction du statut de la traduction.

### Champs communs

**projectId** `string` *required*

L'identifiant unique du projet

**projectName** `string` *required*

Le nom du projet

**originalVideoUrl** `string` *required*

URL du fichier vidéo/audio original téléchargé

**originalLanguage** `string` *required*

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

**targetLanguage** `string` *required*

La langue cible pour la traduction

**duration** `number` *required*

Durée du contenu en secondes

**createdAt** `number` *required*

Horodatage Unix de création du projet

**workflow** `string` *required*

Flux de travail API ayant créé le projet : `translation` ou `transcription`.

**transcriptionStatus** `string` *required*

Statut de la transcription source : `processing`, `success` ou `failed`. Ce signal est indépendant de l'achèvement du doublage.

**transcripts** `object` *required*

Transcriptions normalisées disponibles.

**propriétés des transcriptions**

**transcripts.original** `object | null`

Transcription en langue originale lorsqu'elle est disponible, incluant les horodatages et les locuteurs.

**transcripts.translations** `array`

Transcriptions disponibles dans la langue cible, avec leur langue et leurs identifiants de travail. Les segments traduits portent `finalSpeedFactor` une fois qu'une voix a été générée (voir [Exporter la transcription du projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/project-transcript.md)).

**workId** `string`

Identifiant de travail de traduction pour la version traduite actuellement rapportée.

**translatedVersionId** `string`

Identifiant de version traduite pour la version traduite actuellement rapportée.

**actualProgressStep** `string`

Étape actuelle du projet. Pendant la création ou la transcription, cela reflète l'étape de création active.
Les exemples incluent `downloading_content`, `content_validation` et `transcription_processing`.
Une fois le doublage lancé, il peut passer à une étape de doublage active telle que `smart_sync` ou `audio_assembling`.
`status: processing` peut coexister avec `actualProgressStep: done` lorsqu’une étape ultérieure, comme la synchronisation labiale, est encore en cours.

**translationAndTranscriptionProgress** `number`

Pourcentage de progression approximatif pour la création/transcription du projet (0-100)

**dubbingStep** `string`

Étape de doublage actuelle pour la langue cible (par ex. `smart_sync`, `audio_enhancement`, `video_upload`)

**dubbingProgress** `number`

Pourcentage de progression approximatif pour le doublage (0-100)

**status** `string` *required*

Statut actuel de la traduction : `processing`, `success` ou `failed`

### Champs Lip Sync

Lorsque la synchronisation labiale a été demandée, la réponse inclut un objet `lipSync` supplémentaire :

**lipSync** `object`

Statut et détails de sortie de la synchronisation labiale (présents uniquement lorsque la synchronisation labiale a été demandée)

**propriétés lipSync**

**lipSync.jobId** `string`

Identifiant de tâche de synchronisation labiale

**lipSync.status** `string`

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

**lipSync.videoUrl** `string`

URL de la vidéo avec synchronisation labiale. Utilisez cette URL pour la sortie finale avec synchronisation labiale lorsque `lipSync.status` est `COMPLETED`.

**lipSync.errorMessage** `string | null`

Message d’échec VoiceCheap fixe, ou null si aucun échec n’est enregistré.

**lipSync.type** `string`

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

**lipSync.createdAt** `string`

Horodatage ISO de création de la tentative de synchronisation labiale.

**lipSync.requestedAt** `string`

Horodatage ISO de demande de la tentative de synchronisation labiale, lorsqu'il est disponible.

**lipSync.completedAt** `string`

Horodatage ISO d'achèvement de la synchronisation labiale, lorsqu'il est disponible.

**lipSync.failedAt** `string`

Horodatage ISO d'échec de la synchronisation labiale, lorsqu'il est disponible.

**lipSync.timedOutAt** `string`

Horodatage ISO du moment où la synchronisation labiale a expiré, le cas échéant.

**lipSync.activeSpeakerDetectionEnabled** `boolean`

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

> [!NOTE]
>
> Lorsqu'une synchronisation labiale est demandée, la traduction reste dans `processing` jusqu'à ce que `lipSync.status` soit `COMPLETED`. Si la synchronisation labiale échoue, le statut devient
> `failed` et `error.code` est `LIPSYNC_FAILED`. Lorsque la synchronisation labiale réussit, lisez l'élément synchronisé depuis `lipSync.videoUrl` ; `translatedVideoUrl`
> est la sortie vidéo traduite avant la superposition de la synchronisation labiale.

> [!TIP]
>
> Utilisez `GET /v1/projects/{projectId}` lorsque vous avez besoin de l'historique complet des versions traduites ou de l'historique complet de la synchronisation labiale.

### Champs de réponse en cas de succès

Pour les flux de travail de traduction, les champs suivants sont inclus lorsque `status` est `success`. Un flux de travail de transcription seule atteint `success` sans champs de média traduits.

**translatedVideoUrl** `string`

URL pour télécharger le fichier vidéo traduit

**translatedAudioUrl** `string`

URL pour télécharger le fichier audio traduit séparément

### Champs de réponse en cas d'échec

Lorsque `status` est `failed`, le champ supplémentaire suivant est inclus :

**error** `object`

Détails de l'erreur

**propriétés de l'erreur**

**error.code** `string`

Code d'erreur lisible par machine

**error.message** `string`

Description de l'erreur lisible par l'homme

## Exemples

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

```typescript TypeScript theme={null}
type TranslationStatus = 'processing' | 'success' | 'failed';

interface Transcript {
  source: 'original' | 'translated';
  language: string;
  text: string;
  segments: Array<{
    index: number;
    text: string;
    begin: number;
    end: number;
    speaker: number;
  }>;
}

interface TranslationStatusBase {
  projectId: string;
  projectName: string;
  originalVideoUrl: string;
  originalLanguage: string;
  targetLanguage: string;
  duration: number;
  createdAt: number;
  workflow: 'translation' | 'transcription';
  transcriptionStatus: TranslationStatus;
  transcripts: {
    original: Transcript | null;
    translations: Transcript[];
  };
  workId?: string;
  translatedVersionId?: string;
  actualProgressStep?: string;
  translationAndTranscriptionProgress?: number;
  dubbingStep?: string;
  dubbingProgress?: number;
  lipSync?: {
    jobId: string;
    status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REJECTED' | 'CANCELED';
    videoUrl: string;
    errorMessage: string | null;
    type: 'standard' | 'pro' | 'studio';
    createdAt?: string;
    requestedAt?: string;
    completedAt?: string;
    failedAt?: string;
    timedOutAt?: string;
    activeSpeakerDetectionEnabled?: boolean;
  };
}

interface TranslationStatusProcessing extends TranslationStatusBase {
  status: 'processing';
}

interface TranslationStatusSuccess extends TranslationStatusBase {
  status: 'success';
  translatedVideoUrl?: string;
  translatedAudioUrl?: string;
}

interface TranslationStatusFailed extends TranslationStatusBase {
  status: 'failed';
  error: {
    code: string;
    message: string;
  };
}

type TranslationStatusResponse = TranslationStatusProcessing | TranslationStatusSuccess | TranslationStatusFailed;

async function getTranslationStatus(projectId: string): Promise<TranslationStatusResponse> {
  const response = await fetch(`https://api.voicecheap.ai/v1/translate/${projectId}/status`, {
    method: 'GET',
    headers: {
      'x-api-key': 'vc_your-api-key',
    },
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.message || 'Failed to get status');
  }

  return response.json();
}

// Polling function with typed response handling
async function pollUntilComplete(projectId: string, intervalMs: number = 10000): Promise<TranslationStatusSuccess> {
  while (true) {
    const status = await getTranslationStatus(projectId);

    if (status.status === 'success') {
      return status;
    }

    if (status.status === 'failed') {
      throw new Error(`Translation failed: ${status.error.message}`);
    }

    console.log('Still processing...');
    await new Promise((resolve) => setTimeout(resolve, intervalMs));
  }
}

// Usage
try {
  const result = await pollUntilComplete('abc123-def456-ghi789');
  console.log('Translated video:', result.translatedVideoUrl);
  console.log('Translated audio:', result.translatedAudioUrl);
} catch (error) {
  console.error('Error:', error);
}
```

```javascript JavaScript theme={null}
const response = await fetch('https://api.voicecheap.ai/v1/translate/abc123-def456-ghi789/status', {
  method: 'GET',
  headers: {
    'x-api-key': 'vc_your-api-key',
  },
});

const status = await response.json();

if (status.status === 'success') {
  console.log('Translated video:', status.translatedVideoUrl);
} else if (status.status === 'processing') {
  console.log('Still processing...');
} else if (status.status === 'failed') {
  console.error('Translation failed:', status.error.message);
}
```

```python Python theme={null}
import requests
import time

headers = {'x-api-key': 'vc_your-api-key'}
project_id = 'abc123-def456-ghi789'

# Poll until complete
while True:
    response = requests.get(
        f'https://api.voicecheap.ai/v1/translate/{project_id}/status',
        headers=headers
    )
    status = response.json()

    if status['status'] == 'success':
        print(f"Translated video: {status['translatedVideoUrl']}")
        print(f"Translated audio: {status['translatedAudioUrl']}")
        break
    elif status['status'] == 'failed':
        print(f"Translation failed: {status['error']['message']}")
        break
    else:
        print("Still processing...")
        time.sleep(10)  # Wait 10 seconds before polling again
```

```php PHP theme={null}
<?php
$apiKey = 'vc_your-api-key';
$projectId = 'abc123-def456-ghi789';

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.voicecheap.ai/v1/translate/{$projectId}/status",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "x-api-key: {$apiKey}"
    ]
]);

$response = curl_exec($curl);
$status = json_decode($response, true);

switch ($status['status']) {
    case 'success':
        echo "Translated video: " . $status['translatedVideoUrl'] . "\n";
        echo "Translated audio: " . $status['translatedAudioUrl'];
        break;
    case 'processing':
        echo "Still processing...";
        break;
    case 'failed':
        echo "Failed: " . $status['error']['message'];
        break;
}
```

## Exemples de réponse

### Statut de traitement

```json theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "My Spanish Translation",
  "originalVideoUrl": "https://storage.voicecheap.ai/...",
  "originalLanguage": "en",
  "targetLanguage": "spanish",
  "duration": 125.5,
  "createdAt": 1702234567890,
  "workflow": "translation",
  "transcriptionStatus": "processing",
  "transcripts": { "original": null, "translations": [] },
  "actualProgressStep": "downloading_content",
  "translationAndTranscriptionProgress": 11,
  "dubbingStep": "smart_sync",
  "dubbingProgress": 30,
  "status": "processing"
}
```

### Statut de traitement (Lip Sync demandé)

```json theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "My Spanish Translation",
  "originalVideoUrl": "https://storage.voicecheap.ai/...",
  "originalLanguage": "en",
  "targetLanguage": "spanish",
  "duration": 125.5,
  "createdAt": 1702234567890,
  "workflow": "translation",
  "transcriptionStatus": "success",
  "transcripts": { "original": null, "translations": [] },
  "actualProgressStep": "finalizing",
  "translationAndTranscriptionProgress": 95,
  "dubbingStep": "video_upload",
  "dubbingProgress": 95,
  "status": "processing",
  "lipSync": {
    "jobId": "syncjob_123",
    "status": "PROCESSING",
    "videoUrl": "",
    "errorMessage": null,
    "type": "standard"
  }
}
```

### Statut de succès

```json theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "My Spanish Translation",
  "originalVideoUrl": "https://storage.voicecheap.ai/...",
  "originalLanguage": "en",
  "targetLanguage": "spanish",
  "duration": 125.5,
  "createdAt": 1702234567890,
  "workflow": "translation",
  "transcriptionStatus": "success",
  "transcripts": { "original": null, "translations": [] },
  "status": "success",
  "translatedVideoUrl": "https://storage.voicecheap.ai/translated/...",
  "translatedAudioUrl": "https://storage.voicecheap.ai/audio/..."
}
```

### Statut de succès (Lip Sync terminé)

```json theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "My Spanish Translation",
  "originalVideoUrl": "https://storage.voicecheap.ai/...",
  "originalLanguage": "en",
  "targetLanguage": "spanish",
  "duration": 125.5,
  "createdAt": 1702234567890,
  "workflow": "translation",
  "transcriptionStatus": "success",
  "transcripts": { "original": null, "translations": [] },
  "actualProgressStep": "done",
  "dubbingStep": "done",
  "dubbingProgress": 100,
  "status": "success",
  "translatedVideoUrl": "https://storage.voicecheap.ai/translated/...",
  "translatedAudioUrl": "https://storage.voicecheap.ai/audio/...",
  "lipSync": {
    "jobId": "syncjob_123",
    "status": "COMPLETED",
    "videoUrl": "https://storage.voicecheap.ai/lipsync/...",
    "errorMessage": null,
    "type": "pro"
  }
}
```

### Statut d'échec

```json theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "My Spanish Translation",
  "originalVideoUrl": "https://storage.voicecheap.ai/...",
  "originalLanguage": "en",
  "targetLanguage": "spanish",
  "duration": 125.5,
  "createdAt": 1702234567890,
  "workflow": "translation",
  "transcriptionStatus": "failed",
  "transcripts": { "original": null, "translations": [] },
  "status": "failed",
  "error": {
    "code": "TRANSCRIPTION_FAILED",
    "message": "The transcription could not be completed. Please try again."
  }
}
```

## Bonnes pratiques d'interrogation

> [!NOTE]
>
> **Intervalle d'interrogation recommandé :** 10-30 secondes
>
> Le temps de traduction varie en fonction de la durée et de la complexité de la vidéo. Pour une vidéo typique de 2 minutes, prévoyez 2 à 5 minutes de temps de traitement.

> [!WARNING]
>
> **Limite de débit :** 30 requêtes par minute
>
> Évitez d'interroger plus d'une fois toutes les 2 secondes pour rester dans les limites de débit.

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 401 | `INVALID_API_KEY` | La clé API fournie est invalide |
| 403 | `FORBIDDEN` | Vous n'avez pas accès à ce projet |
| 404 | `PROJECT_NOT_FOUND` | Le projet spécifié n'existe pas |
| 429 | `RATE_LIMIT_EXCEEDED` | Trop de requêtes (limite : 30 requêtes par minute) |


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