Skip to main content

Référence de l’API

L’API VoiceCheap est organisée autour des principes REST. Elle utilise des méthodes HTTP standard, renvoie des réponses encodées en JSON et utilise des codes de réponse HTTP standard.

URL de base

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

Authentification

Toutes les requêtes nécessitent une clé API transmise dans l’en-tête x-api-key. Voir la page Authentification pour plus de détails.

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.

Points de terminaison disponibles

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.

Démarrer la traduction

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

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

Toutes les réponses réussies suivent cette structure générale :
Les réponses d’erreur suivent cette structure :

Codes de statut HTTP