Motion-Transfer-API: eine neue Person in jedes Video setzen

Du hast ein Video, das funktioniert. Jetzt willst du es mit jemand anderem darin: deinem eigenen Creator, einer Kundin oder einer Person, die es noch gar nicht gibt. Die Hermoso-API erledigt das mit einer einzigen Anfrage. Schick das Video und die Person, und die neue Person macht jede Bewegung, jeden Ausdruck und jede Mundform des Originals nach, auf denselben Beats und Schnitten, im selben Raum und Licht. Der Originalton bleibt.

API-Doku lesen →

Wie sieht ein Aufruf aus?

Schick das Video und wer darin sein soll. Mit "dry_run": true läuft nichts, und die Antwort ist der genaue Preis.

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
  }'

Schick dieselbe Anfrage ohne "dry_run": true, und sie startet. Du bekommst sofort einen Job zurück und das fertige Video, sobald es bereit ist: Minuten bei einem kurzen Clip, länger bei einem langen.

Wen kannst du ins Video setzen?

• Deinen gespeicherten Creator oder einen der fertigen KI-Creator, per ID.
• Ein Foto der Person, per Link.
• Eine KI-Person aus deinen Worten. Beschreib sie (Alter, Haare, Stil, Ausstrahlung), und Hermoso erstellt sie zuerst und setzt sie dann ein. Sie landet in deiner Bibliothek, sodass du sie wiederverwenden kannst.

Soll sie auch anders klingen? Füg eine neue Stimme mit denselben Worten und demselben Timing hinzu, oder lass sie eine andere Sprache sprechen, mit dem Mund passend zu den neuen Worten. Es ist dieselbe Anfrage und derselbe Job.

Welche Videos funktionieren?

Ein Link von TikTok, Reel, Facebook, X oder YouTube, ein Link zu einer Videodatei oder eine Datei, die du in Hermoso hochgeladen hast. Ein Aufruf deckt bis zu 60 Sekunden ab, und mit einem Start und einem Ende kannst du einen Ausschnitt wählen.

Was kostet das?

Das hängt von der Länge des Videos ab und davon, ob du eine neue Stimme hinzufügst, deshalb raten wir nie. Ein Probelauf nennt dir den genauen Preis, Schritt für Schritt, bevor etwas läuft. Der echte Aufruf reserviert diesen Betrag und rechnet ab, was das Rendern wirklich gekostet hat, nie mehr. Unter Preise siehst du, was ein Credit wert ist.

Kannst du statt einer Person ein Objekt austauschen?

Ja. Ein zweiter Endpunkt ändert eine Sache in einem Clip nach einer einfachen Anweisung: „ändere nur die Tasse zu Rot“, „tausche die Flasche gegen unser Produkt“, „mach es Nacht“. Bewegung, Timing und Bildausschnitt bleiben. Füg ein Bild des echten Produkts oder Materials hinzu, und die Änderung passt dazu.

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 }'

Nicht sicher, wie es aussehen wird? Frag zuerst nach einer Vorschau eines einzelnen Standbilds. Du siehst die Änderung auf einem Frame, mit dem Preis für den ganzen Clip daneben, und der Clip läuft erst, wenn du es sagst.

Gebaut für dein Backend

• Asynchron. Ein echter Aufruf antwortet sofort mit einem Job. Frag den Job ab, oder gib uns einen Link, und wir schicken dir das fertige Video.
• Sicher zu wiederholen. Schick denselben Idempotenzschlüssel noch einmal, und du bekommst denselben Job zurück, nie ein zweites Rendering.
• Klare Absagen. Wenn etwas nicht laufen kann, erfährst du den Grund, bevor etwas berechnet wird, mit einem Code, auf den dein Code reagieren kann.
• Ein API-Schlüssel aus der App, derselbe, den der MCP-Server und die Kommandozeile nutzen.

Und echte Menschen?

Ein Foto eines echten Menschen braucht einen bezahlten Plan, und mit dem Senden bestätigst du, dass du die Erlaubnis der Person hast. Eine KI-Person aus deinen Worten oder ein fertiger KI-Creator funktioniert in jedem Plan. Anfragen, die jemanden in eine Szene setzen würden, in der er nie sein sollte, werden abgelehnt, bevor etwas läuft.

Lieber klicken statt coden?

Derselbe Tausch steckt auch in der App, unter Person in einem Video austauschen, und dein KI-Agent kann ihn über MCP ausführen. Alle drei nutzen dieselbe Engine und kosten dasselbe.

Häufige Fragen

Was ist eine Motion-Transfer-API?

Sie nimmt ein Video und eine andere Person und gibt das Video mit dieser Person darin zurück. Die Person macht genau das, was die Originalperson getan hat: dieselben Bewegungen, Ausdrücke, dasselbe Timing und dieselben Schnitte. Die Version von Hermoso behält außerdem den Originalton und kann der neuen Person eine neue Stimme oder Sprache geben.

Was kostet ein Personentausch?

Das hängt von der Länge des Videos ab und davon, ob du eine neue Stimme hinzufügst. Schick die Anfrage mit dry_run, und du bekommst den genauen Preis, bevor etwas läuft. Der echte Aufruf berechnet nie mehr als das.

Kann ich ein Foto eines echten Menschen nutzen?

Ja, mit einem bezahlten Plan und nur mit der Erlaubnis dieser Person. Mit dem Senden des Fotos bestätigst du, dass du sie hast. Eine KI-Person aus einer Beschreibung oder ein fertiger KI-Creator funktioniert in jedem Plan.

Wie lange dauert es?

Das hängt von der Länge ab: Minuten bei einem kurzen Clip, länger bei einem langen oder bei einem mit neuer Stimme. Der Aufruf antwortet sofort mit einem Job, und du fragst ihn ab oder bekommst das fertige Video an einen Link deiner Wahl geschickt.

Kann ich statt einer Person ein Objekt ändern?

Ja. Der Edits-Endpunkt ändert eine Sache in einem Clip nach einer einfachen Anweisung, etwa die Farbe einer Tasse ändern oder eine Flasche gegen dein Produkt tauschen, und lässt alles andere, wie es war.