Introduction
Video Translator double un clip parlé dans une autre langue. Envoyez la séquence dans video_url et choisissez target_language ; l’outil transcrit la parole, la traduit, la redouble en la calant sur les répliques d’origine et renvoie la même image avec le nouvel audio. Activez clone_voice et chaque intervenant conserve une voix modélisée à partir de la sienne.
Fonctionnalités et points forts
Les intervenants gardent leur propre voix
Avec clone_voice activé, le doublage est prononcé avec une voix construite à partir de celle de chaque intervenant : dans notre test à deux personnes, la femme et l’homme sont revenus en espagnol avec leur propre timbre, et chaque réplique a commencé au moment où la réplique d’origine commençait.
Gardez la musique ou retirez-la
keep_background_audio décide de ce qui reste sous le doublage. Activé, l’ambiance de la cave et la tonalité de la pièce restent exactement là où elles étaient. Désactivé, le clip renvoyé ne contient que les voix traduites, avec un vrai silence entre les répliques, prêt pour votre propre mixage.
Vos noms restent vos noms
Indiquez les termes dans glossary sous forme de paires {term, translation} : ils seront traduits comme vous le voulez, à chaque fois. Dans notre test, une formule listée dans le glossaire a été reprise mot pour mot dans les deux répliques où elle apparaissait.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
video_url | Oui | Le clip à traduire, de 1 seconde à 10 minutes. L’image revient inchangée. 1 caractères minimum |
target_language | Non | La langue de doublage, parmi les 28. Par défaut English. |
source_language | Non | La langue parlée dans le clip. Par défaut auto, qui la détecte. |
clone_voice | Non | Désactivé par défaut. Activé : chaque intervenant est redoublé avec une voix modélisée à partir de la sienne. Valeur par défaut: |
keep_background_audio | Non | Activé par défaut : la musique et les effets sonores restent sous le doublage. Désactivé : seules les voix traduites sont renvoyées, avec du silence entre les répliques. Valeur par défaut: |
speaker_count | Non | Le nombre de personnes qui parlent dans le clip, de 1 à 4. Omettez-le pour laisser l’outil les compter. |
glossary | Non | Noms, marques et formules à traduction fixe, sous forme de paires terme / traduction, jusqu’à 100. 100 éléments maximum |
Tarification
$0.005 / seconde produite
Facturé en minutes entières du clip source : un clip de 70 secondes coûte donc le même prix que 2 minutes. Le clip doit durer de 1 seconde à 10 minutes ; l’estimation avant envoi utilise la durée réelle d’un clip importé, ou le maximum de 10 minutes pour une URL vidéo, et l’écart éventuel est libéré au règlement de la tâche. Les options comme les voix clonées ou la suppression du fond sonore ne modifient pas le prix.
Cas d’utilisation
Localiser les vidéos courtes
Publiez le même clip sur plusieurs marchés linguistiques sans réserver un comédien pour chacun. Les clips de moins d’une minute coûtent une minute.
Doubler les personnages issus de modèles vidéo
Les personnages générés qui parlent anglais peuvent être doublés dans la langue de votre public, tout en gardant la voix du personnage.
Guide de prompt et conseils pratiques
Indiquez la langue parlée quand il y a de la musique
La détection automatique est fiable sur une parole nette. Sur un clip avec une guitare sous une réplique chuchotée en français, elle a abandonné et la tâche a échoué (remboursée) ; le même clip avec source_language réglé sur le français est passé. Si une tâche échoue avec un message sur le traitement de la vidéo, réglez source_language et renvoyez-la.
Dites combien de personnes parlent
speaker_count est facultatif, mais l’indiquer sur un dialogue à deux personnes garde chaque réplique avec la bonne voix.
Pensez à l’image
Seul l’audio est remplacé. Pour les gros plans où la bouche compte, passez ensuite le clip doublé dans l’outil Lip Sync.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-translator-v1/video-translate",
"input": {
"source_language": "auto",
"target_language": "en",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
