API de transfert de mouvement : placez une nouvelle personne dans n'importe quelle vidéo

Vous avez une vidéo qui marche. Vous la voulez maintenant avec quelqu'un d'autre : votre propre créateur, un client ou une personne qui n'existe pas encore. L'API Hermoso le fait en une seule requête. Envoyez la vidéo et la personne, et la nouvelle personne reprend chaque geste, chaque expression et chaque mouvement de bouche de l'original, sur les mêmes temps et les mêmes coupes, dans la même pièce et sous la même lumière. Le son d'origine reste.

Lire la documentation de l'API →

À quoi ressemble un appel ?

Envoyez la vidéo et la personne qui doit y apparaître. Avec "dry_run": true, rien ne s'exécute, et la réponse est le prix exact.

curl -sX POST https://app.hermoso.ai/v1/recasts \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{
    "video": "https://www.tiktok.com/@someone/video/7400000000000000000",
    "person": { "describe": "a woman in her 30s, curly dark hair, denim jacket" },
    "dry_run": true
  }'

Envoyez la même requête sans "dry_run": true et elle démarre. Vous recevez tout de suite une tâche, puis la vidéo finie quand elle est prête : quelques minutes pour un clip court, plus pour un long.

Qui pouvez-vous mettre dans la vidéo ?

• Votre créateur enregistré, ou l'un des créateurs IA prêts à l'emploi, par son id.
• Une photo de la personne, par lien.
• Une personne IA créée à partir de vos mots. Décrivez-la (âge, cheveux, style, allure) et Hermoso la crée d'abord, puis la place dans la vidéo. Elle arrive dans votre Bibliothèque, vous pouvez donc la réutiliser.

Vous voulez aussi une autre voix ? Ajoutez une nouvelle voix avec les mêmes mots et le même rythme, ou faites-la parler une autre langue avec la bouche calée sur les nouveaux mots. C'est la même requête et la même tâche.

Quelles vidéos fonctionnent ?

Un lien TikTok, Reel, Facebook, X ou YouTube, un lien vers un fichier vidéo ou un fichier que vous avez importé dans Hermoso. Un appel couvre jusqu'à 60 secondes, et vous pouvez choisir un passage avec un début et une fin.

Combien ça coûte ?

Cela dépend de la durée de la vidéo et de l'ajout ou non d'une nouvelle voix, donc nous ne devinons jamais. Un essai à blanc vous donne le prix exact, étape par étape, avant que quoi que ce soit ne s'exécute. L'appel réel réserve ce montant et se règle au coût réel du rendu, jamais plus. Consultez les tarifs pour savoir ce que vaut un crédit.

Peut-on remplacer un objet plutôt qu'une personne ?

Oui. Un second endpoint modifie un élément d'un clip à partir d'une simple consigne : « mets seulement la tasse en rouge », « remplace la bouteille par notre produit », « passe en scène de nuit ». Le mouvement, le rythme et le cadrage restent. Ajoutez une image du vrai produit ou du vrai matériau et la modification s'y conforme.

curl -sX POST https://app.hermoso.ai/v1/edits \
  -H "Authorization: Bearer hmk_..." \
  -H 'content-type: application/json' \
  -d '{ "video": "https://example.com/clip.mp4", "instruction": "change only the mug to red", "dry_run": true }'

Vous ne savez pas à quoi ça ressemblera ? Demandez d'abord un aperçu sur une seule image. Vous voyez la modification sur une image fixe, avec le prix du clip complet à côté, et le clip ne s'exécute que lorsque vous le décidez.

Conçu pour votre backend

• Asynchrone. Un appel réel répond tout de suite avec une tâche. Consultez la tâche, ou donnez-nous un lien et nous vous envoyons la vidéo finie.
• Sans risque à relancer. Renvoyez la même clé d'idempotence et vous récupérez la même tâche, jamais un second rendu.
• Des refus clairs. Quand quelque chose ne peut pas s'exécuter, vous savez pourquoi avant tout débit, avec un code sur lequel votre code peut s'appuyer.
• Une seule clé API depuis l'app, la même que celle du serveur MCP et de la ligne de commande.

Et les vraies personnes ?

La photo d'une vraie personne demande un forfait payant, et l'envoyer confirme que vous avez son autorisation. Une personne IA créée à partir de vos mots, ou un créateur IA prêt à l'emploi, fonctionne avec tous les forfaits. Les requêtes qui placeraient quelqu'un dans une scène où il ne devrait jamais se trouver sont refusées avant toute exécution.

Vous préférez cliquer plutôt que coder ?

Le même remplacement existe dans l'app, dans remplacer une personne dans une vidéo, et votre agent IA peut le lancer via MCP. Les trois utilisent le même moteur et coûtent la même chose.

Questions fréquentes

Qu'est-ce qu'une API de transfert de mouvement ?

Elle prend une vidéo et une autre personne, et renvoie la vidéo avec cette personne, qui fait exactement ce que faisait la personne d'origine : mêmes gestes, mêmes expressions, même rythme et mêmes coupes. La version de Hermoso garde aussi le son d'origine et peut donner à la nouvelle personne une nouvelle voix ou une autre langue.

Combien coûte le remplacement d'une personne ?

Cela dépend de la durée de la vidéo et de l'ajout ou non d'une nouvelle voix. Envoyez la requête avec dry_run et vous obtenez le prix exact avant toute exécution. L'appel réel ne facture jamais plus que ce montant.

Puis-je utiliser la photo d'une vraie personne ?

Oui, avec un forfait payant, et seulement avec l'autorisation de cette personne. Envoyer la photo confirme que vous l'avez. Une personne IA créée à partir d'une description, ou un créateur IA prêt à l'emploi, fonctionne avec tous les forfaits.

Combien de temps cela prend-il ?

Cela dépend de la durée : quelques minutes pour un clip court, plus pour un long ou pour un clip avec une nouvelle voix. L'appel répond tout de suite avec une tâche, et vous la consultez ou recevez la vidéo finie sur un lien de votre choix.

Puis-je modifier un objet plutôt qu'une personne ?

Oui. L'endpoint d'édition modifie un élément d'un clip à partir d'une simple consigne, comme changer la couleur d'une tasse ou remplacer une bouteille par votre produit, et laisse tout le reste tel quel.