Skip to main content

​
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. Ces processus sont aussi disponibles via le serveur MCP du compte, à 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 et consultez les limites d’utilisation.

​
URL de base

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

​
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 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 :
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 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, ou découvrez les actions et schémas autorisés pour votre clé. 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

Transcrire un média

POST /v1/transcribeTranscrivez un fichier téléchargé au format JSON, SRT ou VTT.

Exporter la transcription du projet

POST /v1/projects/{projectId}/transcriptRécupérez les transcriptions originales ou traduites du projet.

Créer un projet

POST /v1/projectsImportez un fichier vidéo ou audio et lancez uniquement la transcription.

Démarrer la traduction

POST /v1/translateTéléchargez un fichier vidéo ou audio et démarrez un projet de traduction.

Doubler un projet

POST /v1/projects/{projectId}/dubDoublez un projet transcrit à partir de votre propre fichier SRT traduit.

Obtenir le statut de la traduction

GET /v1/translate/{projectId}/statusVérifiez le statut d’un projet de traduction et récupérez les résultats.

Obtenir les détails du projet

GET /v1/projects/{projectId}Récupérez l’historique des versions traduites, l’historique de la synchronisation labiale et l’état du projet.

Supprimer le projet

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 :

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

​
Codes de statut HTTP