API di trasferimento del movimento: metti una persona nuova in qualsiasi video

Hai un video che funziona. Ora lo vuoi con un'altra persona: il tuo creator, un cliente o qualcuno che ancora non esiste. L'API di Hermoso lo fa con una sola richiesta. Invia il video e la persona, e la persona nuova ripete ogni movimento, espressione e labiale dell'originale, sugli stessi tempi e tagli, nella stessa stanza e con la stessa luce. L'audio originale resta.

Leggi la documentazione dell'API →

Com'è fatta una chiamata?

Invia il video e chi deve comparire. Con "dry_run": true non parte nulla, e la risposta è il prezzo esatto.

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

Invia la stessa richiesta senza "dry_run": true e parte. Ricevi subito un job, e il video finito quando è pronto: minuti per una clip breve, di più per una lunga.

Chi puoi mettere nel video?

• Il tuo creator salvato, o uno dei creator IA già pronti, tramite id.
• Una foto della persona, tramite link.
• Una persona IA dalle tue parole. Descrivila (età, capelli, stile, atteggiamento) e Hermoso prima la crea, poi la mette nel video. Finisce nella tua Libreria, così puoi riutilizzarla.

Vuoi che abbia anche una voce diversa? Aggiungi una voce nuova con le stesse parole e gli stessi tempi, oppure falla parlare in un'altra lingua con il labiale sincronizzato sulle nuove parole. È la stessa richiesta e lo stesso job.

Quali video funzionano?

Un link di TikTok, Reel, Facebook, X o YouTube, un link a un file video o un file che hai caricato su Hermoso. Una chiamata copre fino a 60 secondi, e puoi scegliere un intervallo con un inizio e una fine.

Quanto costa?

Dipende dalla durata del video e dal fatto che tu aggiunga una voce nuova, quindi non tiriamo mai a indovinare. Una prova a vuoto ti dà il prezzo esatto, passo per passo, prima che parta qualcosa. La chiamata reale riserva quell'importo e si chiude su quanto è costato davvero il render, mai di più. Vedi i prezzi per sapere quanto vale un credito.

Puoi sostituire un oggetto invece di una persona?

Sì. Un secondo endpoint cambia una cosa in una clip con una semplice istruzione: "cambia solo la tazza in rosso", "sostituisci la bottiglia con il nostro prodotto", "rendila notturna". Movimento, tempi e inquadratura restano. Aggiungi un'immagine del prodotto o del materiale reale e la modifica si adegua.

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

Non sai come verrà? Chiedi prima un'anteprima su un solo fotogramma. Vedi la modifica su un'immagine fissa, con accanto il prezzo della clip intera, e la clip parte solo quando lo dici tu.

Pensato per il tuo backend

• Asincrono. Una chiamata reale risponde subito con un job. Controlla il job, oppure dacci un link e ti mandiamo il video finito.
• Sicuro da ripetere. Invia di nuovo la stessa chiave di idempotenza e ricevi lo stesso job, mai un secondo render.
• Rifiuti chiari. Quando qualcosa non può partire, sai perché prima che venga addebitato nulla, con un codice su cui il tuo codice può basarsi.
• Una sola chiave API dall'app, la stessa che usano il server MCP e la riga di comando.

E le persone reali?

La foto di una persona reale richiede un piano a pagamento, e inviarla conferma che hai il suo permesso. Una persona IA dalle tue parole, o un creator IA già pronto, funziona con tutti i piani. Le richieste che metterebbero qualcuno in una scena in cui non dovrebbe mai trovarsi vengono rifiutate prima che parta qualcosa.

Preferisci cliccare invece di programmare?

Lo stesso scambio è nell'app, in sostituire una persona in un video, e il tuo agente IA può eseguirlo tramite MCP. Tutti e tre usano lo stesso motore e costano uguale.

Domande frequenti

Cos'è un'API di trasferimento del movimento?

Prende un video e una persona diversa e restituisce il video con quella persona, che fa esattamente ciò che faceva la persona originale: stessi movimenti, espressioni, tempi e tagli. La versione di Hermoso mantiene anche l'audio originale e può dare alla persona nuova una voce o una lingua diversa.

Quanto costa sostituire la persona in un video?

Dipende dalla durata del video e dal fatto che tu aggiunga una voce nuova. Invia la richiesta con dry_run e ricevi il prezzo esatto prima che parta qualcosa. La chiamata reale non addebita mai di più.

Posso usare la foto di una persona reale?

Sì, con un piano a pagamento e solo con il permesso di quella persona. Inviare la foto conferma che ce l'hai. Una persona IA creata da una descrizione, o un creator IA già pronto, funziona con tutti i piani.

Quanto tempo ci vuole?

Dipende dalla durata: minuti per una clip breve, di più per una lunga o per una con voce nuova. La chiamata risponde subito con un job, e tu lo controlli oppure ricevi il video finito a un link che scegli.

Posso cambiare un oggetto invece di una persona?

Sì. L'endpoint delle modifiche cambia una cosa in una clip con una semplice istruzione, come cambiare il colore di una tazza o sostituire una bottiglia con il tuo prodotto, e lascia tutto il resto com'era.