Skip to main content
Démarrer la traduction

Démarrer la traduction

Créez un nouveau projet de traduction en téléchargeant un fichier vidéo ou audio. Le processus de traduction s’exécute de manière asynchrone en arrière-plan. Utilisez le point de terminaison de statut pour suivre la progression et récupérer les résultats. Utilisez Obtenir les détails du projet lorsque vous avez besoin de l’historique des versions traduites ou de l’historique de la synchronisation labiale.

Limite de concurrence

La création de projets, la traduction et le doublage vérifient tous la limite de traductions actives de votre compte (10 au maximum, parfois moins). Seules les traductions ou les opérations de doublage en cours occupent des places ; les projets limités à la transcription n’en occupent pas. Lorsque cette limite est atteinte, l’API renvoie CONCURRENT_TRANSLATION_LIMIT_REACHED (HTTP 429). La limite appliquée figure dans details.limit.

Requête

Ce point de terminaison accepte multipart/form-data avec un téléchargement de fichier.

En-têtes

string
requis
Votre clé API VoiceCheap. Obtenez-en une sur app.voicecheap.ai/page-api.

Paramètres du corps de la requête

file
requis
Le fichier vidéo ou audio à traduire.Formats vidéo pris en charge : video/mp4, video/quicktime, video/x-matroska, video/webm, video/mpegFormats audio pris en charge : audio/mpeg, audio/wav, audio/mp4, audio/x-m4a, audio/flac, audio/ogg, audio/aac, audio/webmTaille maximale de fichier par forfait : Beginner 5 Go, Starter 10 Go, Creator 20 Go, Pro 30 Go, Scale 40 Go et Enterprise 60 Go.
string
requis
La langue vers laquelle traduire le contenu. Doit être en minuscules.Valeurs autorisées (70+) : afrikaans, albanian, amharic, arabic, armenian, assamese, azerbaijani, basque, belarusian, bengali, bosnian, bulgarian, catalan, croatian, czech, danish, dutch, english, british english, estonian, finnish, french, french canadian, galician, german, greek, gujarati, hebrew, hindi, hungarian, icelandic, indonesian, irish, italian, japanese, kannada, kazakh, khmer, korean, lao, latvian, lithuanian, macedonian, malay, malayalam, mandarin, marathi, mongolian, nepali, norwegian, persian, polish, portuguese, brazilian portuguese, pt_brazil, punjabi, romanian, russian, serbian, slovak, slovenian, spanish, swahili, swedish, tagalog, tamil, telugu, thai, turkish, ukrainian, urdu, vietnamese, welsh, yoruba, zulu
string
La langue source du contenu en utilisant les codes de langue ISO (par ex. en, es, fr, de, ja, zh).
Fortement recommandé : Laissez ce champ vide pour la détection automatique.Ne fournissez ce paramètre que si vous êtes sûr à 100 % que le code de langue est correct et au format ISO valide. Des codes de langue incorrects entraîneront des échecs de transcription. Notre détection automatique prend en charge plus de 80 langues et est très précise.
Par défaut : auto-detect
string
Un nom personnalisé pour le projet. Utile pour identifier les projets dans votre tableau de bord.Par défaut : L’ID du projet sera utilisé s’il n’est pas fourni.
string
Un point de terminaison https qui reçoit les événements webhook pour ce projet, remplaçant le point de terminaison configuré sur votre compte.Par défaut : Le point de terminaison webhook du compte, lorsqu’il est configuré.
string
auto-detect ou un entier de 1 à 32. Un nombre de locuteurs connu peut améliorer la diarisation.Par défaut : auto-detect
string
Un tableau de chaînes JSON contenant des noms, marques, acronymes ou termes spécialisés spécifiques à la requête. Ces termes sont fusionnés avec le vocabulaire enregistré du compte ou de l’équipe.
boolean
Supprimez les mots de remplissage courants de la transcription source avant la traduction.Par défaut : true
string
Une transcription SRT existante dans la langue source. originalLanguage doit être explicite lorsque ce champ est fourni.
string
Le SRT final dans la langue cible, rédigé par vous. Lorsqu’il est fourni, VoiceCheap ignore son moteur de traduction et génère seulement les voix, puis mélange la sortie à partir de ce texte. Voir le mode doublage seul pour les règles d’alignement. Maximum 1 000 000 caractères.
boolean
Indique s’il faut conserver l’audio d’arrière-plan dans la sortie.Lorsqu’il est activé, conserve la musique d’arrière-plan, l’ambiance, les rires, les applaudissements et les sons de foule tout en supprimant uniquement la voix originale (séparation des pistes). Désactivez cette option si votre source ne contient pas d’audio d’arrière-plan.Par défaut : true
boolean
Gardez la voix du locuteur original en sourdine sous la voix traduite.Par défaut : false
number
Volume de la voix originale de 1 à 70 lorsque keepOriginalVoice est activé.Par défaut : 30
string
Mode d’isolation vocale lorsque keepBackgroundMusic est activé. Contrôle la qualité et les caractéristiques de la séparation vocale.
Notre traitement vocal par défaut, conçu pour une qualité audio professionnelle :
  • Supprime les échos et les réverbérations
  • Nettoie les imperfections techniques
  • Produit une voix claire et nette
Recommandé pour : La plupart des projets où la qualité audio est primordiale. Idéal pour les tutoriels, le contenu éducatif, les vidéos marketing et tout contenu nécessitant une clarté vocale optimale.
Préserve les caractéristiques naturelles de l’environnement d’enregistrement :
  • Maintient un son plus proche de l’enregistrement original
  • Préserve les caractéristiques environnementales
Recommandé pour : Le contenu où l’authenticité de l’environnement est importante, comme les vlogs en extérieur, les documentaires ou le contenu où l’ambiance sonore fait partie intégrante de l’expérience.
Cette option peut créer des artefacts ou des effets inattendus dans certains cas en raison de la préservation des éléments d’arrière-plan.
Valeurs autorisées : studio, realisticPar défaut : studio
boolean
Indique s’il faut générer des sous-titres pour la vidéo traduite.Lorsque cette option est activée, elle ajoute des sous-titres noirs et blancs lisibles. Utilisez subtitlesSource pour choisir le texte original (langue source) ou traduit (langue cible). Les sous-titres sont automatiquement synchronisés pour faciliter la lecture.Par défaut : false
string
Choisissez la source du texte des sous-titres lorsque subtitles est activé.Valeurs autorisées : translated, originalPar défaut : translatedRemarque : Si original est sélectionné mais que la transcription originale n’est pas disponible, les sous-titres basculent sur translated.
string
Déclencher le traitement de la synchronisation labiale une fois la traduction terminée.
  • standard = Lip Sync
  • pro = Lip Sync Pro
  • studio = Lip Sync Studio
Les modes premium appliquent leurs exigences habituelles en matière de forfait, de durée et de crédits.Par défaut : omettez le champ pour ignorer la synchronisation labiale.
boolean
Activer la détection du locuteur actif pour l’exécution de la synchronisation labiale demandée.Par défaut : false
boolean
Sélecteur de synchronisation labiale hérité conservé pour la compatibilité ascendante.
  • false = Synchronisation labiale standard (4 minutes de crédits par minute de vidéo)
  • true = Lip Sync Pro (9 minutes de crédits par minute de vidéo)
Lip Sync Pro est disponible à partir du forfait Creator.
Durée maximale : 180 minutes par vidéo.Latence : Le traitement de la synchronisation labiale ajoute généralement 2x à 4x la durée de la vidéo originale.
Les e-mails de fin et d’échec de la synchronisation labiale ne sont pas envoyés pour les demandes déclenchées par l’API. Utilisez le point de terminaison de statut pour suivre la progression.
Par défaut : non activé (omettez le champ pour ignorer la synchronisation labiale)Form-data : Envoyez les valeurs booléennes sous forme de chaînes true ou false (par ex., -F "lipsyncPro=false").
Ne combinez pas lipsyncPro avec un lipSyncMode contradictoire.
string
Stratégie vocale : cloning ou custom.Par défaut : cloning
string
Requis lorsque voiceMode est custom. Utilisez un identifiant de dubbing_voices_list : une voix du catalogue ou une voix personnalisée enregistrée par le compte authentifié. La facturation en équipe ne donne pas accès aux voix enregistrées des autres membres.
object
Affinez les paramètres de clonage vocal pour un contrôle avancé sur la voix générée. Transmettez sous forme de chaîne JSON lors de l’utilisation de form-data. Toutes les valeurs doivent être comprises entre 0 et 1 (avec un pas de 0,01). Une valeur speakerBoost envoyée par d’anciennes intégrations est toujours acceptée, mais n’a plus aucun effet.
Ces paramètres ne s’appliquent que lorsque voiceMode est cloning.
Valeurs par défaut (équilibrées) :
string
Un tableau JSON de plages temporelles sources qui doivent rester dans la langue originale.
Les sauts temporels nécessitent une entrée vidéo et keepBackgroundMusic=true. Ils ne peuvent pas être combinés avec keepOriginalVoice et ne peuvent pas chevaucher les segments de transcription.

Mode doublage seul (apportez votre traduction)

Envoyez translatedSrt lorsque vous avez déjà la traduction et que VoiceCheap ne doit générer que les voix et mixer la sortie. Dans ce mode :
  • Pas de traduction par IA ni de reformulation SmartSync. Chaque réplique est lue telle quelle. Les règles de glossaire enregistrées et les instructions de traduction personnalisées ne s’appliquent pas non plus, car elles ne s’exécutent que sur le moteur de traduction.
  • Le minutage vient de la source. Chaque segment conserve le début, la fin et le locuteur de la transcription source ; les codes temporels de votre SRT servent uniquement à associer les répliques aux segments. La voix générée est accélérée ou ralentie pour tenir dans la fenêtre du segment, sans reformulation.
  • Les mêmes crédits qu’une traduction. L’exécution est facturée exactement comme une traduction standard du même média.
  • Les options de voix, d’arrière-plan, de sous-titres et de synchronisation labiale s’appliquent sans changement. voiceMode, keepBackgroundMusic, subtitles, lipSyncMode et les autres options de doublage se comportent comme documenté ci-dessus.
Le message de la réponse confirme le mode, et la version traduite indique dubbingMode: "dub-only" dans Obtenir les détails du projet.

Règles d’alignement

Les problèmes d’alignement en mode timestamps ne sont connus qu’après la transcription et sont signalés de façon asynchrone. Le point de terminaison de statut répond en HTTP 200 avec status: "failed" et un error contenant code et message ; le webhook project.translation.failed porte le même code et le même message. TRANSLATED_SRT_UNMATCHED_CUES indique dans le message les numéros de répliques sans correspondance, tandis que TRANSLATED_SRT_MISSING_SEGMENTS indique les index des segments sans réplique. Ces réponses ne contiennent pas de champ details structuré. Pour une correspondance déterministe, envoyez sourceSrt avec translatedSrt, ou créez d’abord le projet avec Créer un projet, exportez sa transcription, traduisez-la réplique par réplique et appelez Doubler le projet.

Vérifier le rythme

Les phrases longues doivent être accélérées pour tenir dans leur segment. Exportez la transcription traduite avec Exporter la transcription du projet : chaque segment traduit porte finalSpeedFactor, le rapport entre la voix générée et la fenêtre du segment avant l’ajustement final du tempo. Raccourcissez les répliques qui dépassent environ 1.3, puis relancez le doublage avec le SRT révisé.
translatedSrt est aussi accepté par le point de terminaison JSON Doubler le projet, qui double un projet déjà transcrit sans téléverser à nouveau le média.

Réponse

boolean
requis
Toujours true pour les demandes réussies
string
requis
Un message lisible par l’homme décrivant le résultat
string
requis
L’identifiant unique du projet de traduction créé. Utilisez cet ID pour vérifier le statut.
number
requis
Estimation approximative du traitement en minutes. L’estimation actuelle est de cinq minutes de traitement par minute de média source lancée.

Exemples

Les règles de glossaire enregistrées et les instructions de traduction personnalisées du compte ou de l’équipe effective sont appliquées automatiquement.

Exemple de réponse

Erreurs