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

# Référence de l'API

> Référence complète pour l'API REST VoiceCheap

# Référence de l'API

L’API VoiceCheap utilise les méthodes et codes de statut HTTP standard. La plupart des points de terminaison renvoient du JSON ; les exportations de transcriptions peuvent aussi renvoyer du SRT ou du VTT.

Pour les paramètres du compte, la gestion de l’équipe, les outils média et d’autres processus, utilisez le [catalogue des actions](https://api-docs.voicecheap.ai/docs/fr/api-reference/actions.md). Ces processus sont aussi disponibles via le [serveur MCP du compte](https://api-docs.voicecheap.ai/docs/fr/ai/model-context-protocol.md), à l’exception de la création et de la rotation du secret de signature des webhooks, qui nécessitent REST. Gérez les identifiants dans les [Intégrations](https://api-docs.voicecheap.ai/docs/fr/ai/integrations.md) et consultez les [limites d’utilisation](https://api-docs.voicecheap.ai/docs/fr/api-reference/limits.md).

## URL de base

Toutes les requêtes API doivent être effectuées vers :

```text theme={null}
https://api.voicecheap.ai
```

## Authentification

Authentifiez les appels REST privés avec une clé API dans `x-api-key` ou `Authorization: Bearer`. Le document OpenAPI est public. Consultez la page [Authentification](https://api-docs.voicecheap.ai/docs/fr/authentication.md) pour les identifiants à autorisations limitées et OAuth pour MCP.

## API d’actions JSON

Les sections compte, équipe, projets, voix et outils média détaillent chaque action JSON. Toutes ces routes utilisent `POST`, y compris pour lire ou supprimer ; envoyez les paramètres dans le corps JSON. Les routes d’envoi de fichiers et de projet ci-dessous conservent leurs propres méthodes HTTP.

Créez une clé API avec le droit `account:read`, définissez la variable d’environnement `VOICECHEAP_API_KEY`, puis essayez cette requête en lecture seule :

```bash theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/account_get' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'
```

Une action terminée renvoie HTTP 200 avec son résultat dans `data`. Une action longue renvoie HTTP 202 et un `requestId` ; utilisez le [suivi de requête](https://api-docs.voicecheap.ai/docs/fr/api-reference/actions/requests/action-request-get.md) pour récupérer le résultat. Une tâche média peut continuer après la fin de la requête d’action.

Parcourez [toutes les fiches par domaine](https://api-docs.voicecheap.ai/docs/fr/api-reference/actions.md), ou [découvrez les actions et schémas autorisés pour votre clé](https://api-docs.voicecheap.ai/docs/fr/api-reference/discovery/actions-list.md). Chaque fiche précise les droits, paramètres, exemples et erreurs.

## Types de contenu

* **Requête** : Utilisez `multipart/form-data` pour les téléchargements de fichiers, `application/json` pour les autres requêtes
* **Réponse** : Les points de terminaison JSON renvoient `application/json`. Les exportations de transcriptions peuvent également renvoyer du texte SRT ou VTT.

## Envoi de fichiers et routes de projet existantes

> [card] [Transcrire un média](https://api-docs.voicecheap.ai/docs/fr/api-reference/transcribe.md)
>
> `POST /v1/transcribe`
>
> Transcrivez un fichier téléchargé au format JSON, SRT ou VTT.

> [card] [Exporter la transcription du projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/project-transcript.md)
>
> `POST /v1/projects/{projectId}/transcript`
>
> Récupérez les transcriptions originales ou traduites du projet.

> [card] [Créer un projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/create-project.md)
>
> `POST /v1/projects`
>
> Importez un fichier vidéo ou audio et lancez uniquement la transcription.

> [card] [Démarrer la traduction](https://api-docs.voicecheap.ai/docs/fr/api-reference/translate.md)
>
> `POST /v1/translate`
>
> Téléchargez un fichier vidéo ou audio et démarrez un projet de traduction.

> [card] [Doubler un projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/dub-project.md)
>
> `POST /v1/projects/{projectId}/dub`
>
> Doublez un projet transcrit à partir de votre propre fichier SRT traduit.

> [card] [Obtenir le statut de la traduction](https://api-docs.voicecheap.ai/docs/fr/api-reference/translation-status.md)
>
> `GET /v1/translate/{projectId}/status`
>
> Vérifiez le statut d'un projet de traduction et récupérez les résultats.

> [card] [Obtenir les détails du projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/project-details.md)
>
> `GET /v1/projects/{projectId}`
>
> Récupérez l'historique des versions traduites, l'historique de la synchronisation labiale et l'état du projet.

> [card] [Supprimer le projet](https://api-docs.voicecheap.ai/docs/fr/api-reference/delete-project.md)
>
> `DELETE /v1/translate/{projectId}`
>
> Supprimez définitivement un projet de traduction et ses ressources.

## Flux de travail de traduction

Le flux de travail typique pour traduire une vidéo est :

```mermaid theme={null}
sequenceDiagram
    participant Client as Client
    participant API
    participant Processing as Traitement

    Client->>API: POST /v1/translate (fichier + options)
    API->>Processing: Mettre la traduction en file d’attente
    API-->>Client: 201 (projectId)

    loop Consulter le statut
        Client->>API: GET /v1/translate/{projectId}/status
        API-->>Client: status (processing/success/failed)
    end

    Note over Client: Télécharger l’URL de la vidéo traduite quand le statut est "success"
```

## Format de réponse

Les routes d’envoi de fichiers et de projet existantes ci-dessous conservent leur format de réponse propre.

Les champs d’une réponse réussie dépendent du point de terminaison. La création d’un projet et le lancement d’un doublage renvoient `success`, `message` et `projectId`. Les requêtes de statut et de détails renvoient l’état du projet ; les requêtes de transcription renvoient du JSON, du SRT ou du VTT. Consultez chaque page pour connaître la réponse exacte.

Les erreurs renvoient un objet JSON avec `code` et `message`, parfois avec `details`. Voir les [codes d’erreur](https://api-docs.voicecheap.ai/docs/fr/api-reference/errors.md).

## Codes de statut HTTP

| Code de statut | Description |
| - | - |
| 200 | Succès |
| 201 | Créé – Un projet ou un doublage a été lancé |
| 202 | Accepté - Suivez l’action asynchrone avec son identifiant de requête |
| 400 | Requête incorrecte - Paramètres invalides |
| 401 | Non autorisé - Clé API invalide ou manquante |
| 403 | Interdit - Autorisations ou crédits insuffisants |
| 404 | Non trouvé - La ressource n'existe pas |
| 409 | Conflit – L’état du projet ne permet pas la requête |
| 413 | Fichier trop volumineux – Le fichier dépasse sa limite |
| 429 | Trop de requêtes - Limite de débit dépassée |
| 500 | Erreur interne du serveur |
| 502 | Erreur de traitement – La transcription n’a pas pu aboutir |
| 503 | Service temporairement indisponible - Gardez le même identifiant et vérifiez le statut avant de réessayer |


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