Mozgásátviteli API: tegyél új embert bármelyik videóba

Van egy videód, ami működik. Most valaki mással szeretnéd: a saját kreátoroddal, egy vásárlóval vagy egy olyan emberrel, aki még nem is létezik. A Hermoso API ezt egyetlen kéréssel megoldja. Küldd el a videót és a személyt, és az új ember előadja az eredeti minden mozdulatát, arckifejezését és szájmozgását, ugyanazokra az ütemekre és vágásokra, ugyanabban a térben és fényben. Az eredeti hang megmarad.

Az API dokumentációja →

Hogyan néz ki egy hívás?

Küldd el a videót, és azt, hogy ki legyen benne. A "dry_run": true használatával semmi sem fut le, a válasz pedig a pontos ár.

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

Küldd el ugyanezt a kérést "dry_run": true nélkül, és elindul. Azonnal kapsz egy feladatot, a kész videót pedig, amint elkészül: rövid klipnél percek alatt, hosszabbnál tovább tart.

Kit tehetsz bele a videóba?

• A mentett kreátorodat vagy az egyik kész AI-kreátort, azonosító alapján.
• Egy fotót az emberről, link alapján.
• Egy AI-embert a saját szavaidból. Írd le (kor, haj, stílus, hangulat), és a Hermoso előbb elkészíti, aztán beteszi a videóba. A Könyvtáradba kerül, így újra használhatod.

Azt szeretnéd, hogy másképp is szóljon? Adj hozzá egy új hangot ugyanazokkal a szavakkal és időzítéssel, vagy beszéljen egy másik nyelven, az új szavakhoz igazított szájmozgással. Ez ugyanaz a kérés és ugyanaz a feladat.

Milyen videók működnek?

Egy TikTok, Reel, Facebook, X vagy YouTube link, egy videófájl linkje vagy egy fájl, amit feltöltöttél a Hermoso-ba. Egy hívás legfeljebb 60 másodpercet fed le, és kezdő- és végponttal kiválaszthatsz egy szakaszt.

Mennyibe kerül?

A videó hosszától függ, és attól, hogy adsz-e hozzá új hangot, ezért sosem találgatunk. Egy próbafuttatás lépésről lépésre megadja a pontos árat, mielőtt bármi elindulna. A valódi hívás ennyit foglal le, és azzal az összeggel számol el, amennyibe a renderelés ténylegesen került, soha nem többel. Hogy mennyit ér egy kredit, az árak oldalon látod.

Személy helyett tárgyat is cserélhetsz?

Igen. Egy második végpont egy egyszerű utasítás alapján egyetlen dolgot változtat meg egy klipben: „csak a bögrét változtasd pirosra”, „cseréld le az üveget a termékünkre”, „legyen éjszaka”. A mozgás, az időzítés és a képkivágás megmarad. Adj hozzá egy képet a valódi termékről vagy anyagról, és a változtatás ahhoz igazodik.

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

Nem vagy biztos benne, hogyan fog kinézni? Kérj előbb előnézetet egyetlen állóképen. Egy képkockán látod a változtatást, mellette a teljes klip árával, és a klip csak akkor fut le, amikor szólsz.

A backendedhez tervezve

• Aszinkron. Egy valódi hívás azonnal egy feladattal válaszol. Ellenőrizd a feladatot, vagy adj meg egy linket, és elküldjük a kész videót.
• Biztonságosan újrapróbálható. Küldd el újra ugyanazt az idempotenciakulcsot, és ugyanazt a feladatot kapod vissza, soha nem egy második renderelést.
• Érthető elutasítások. Ha valami nem futhat le, még bármilyen terhelés előtt megtudod, miért, egy kóddal, amely alapján a kódod elágazhat.
• Egyetlen API-kulcs az appból, ugyanaz, amit az MCP-szerver és a parancssor is használ.

Mi a helyzet a valódi emberekkel?

Egy valódi ember fotójához fizetős csomag kell, és a fotó elküldésével megerősíted, hogy megvan az engedélye. A saját szavaidból készült AI-ember vagy egy kész AI-kreátor minden csomagban működik. Azokat a kéréseket, amelyek valakit olyan jelenetbe tennének, ahol soha nem lenne szabad lennie, még a futtatás előtt elutasítjuk.

Inkább kattintanál, mint kódolnál?

Ugyanez a csere az appban is megvan, a személy cseréje videóban oldalon, és az AI-ügynököd az MCP-n keresztül is futtathatja. Mindhárom ugyanazt a motort használja, és ugyanannyiba kerül.

Gyakran ismételt kérdések

Mi az a mozgásátviteli API?

Fogad egy videót és egy másik embert, és visszaadja a videót ezzel az emberrel, aki pontosan azt csinálja, amit az eredeti: ugyanazokat a mozdulatokat, arckifejezéseket, időzítést és vágásokat. A Hermoso változata az eredeti hangot is megtartja, és új hangot vagy nyelvet is adhat az új embernek.

Mennyibe kerül egy személycsere?

A videó hosszától függ, és attól, hogy adsz-e hozzá új hangot. Küldd el a kérést dry_run beállítással, és megkapod a pontos árat, mielőtt bármi elindulna. A valódi hívás soha nem számol fel ennél többet.

Használhatom egy valódi ember fotóját?

Igen, fizetős csomaggal, és csak az illető engedélyével. A fotó elküldésével megerősíted, hogy megvan. Egy leírásból készült AI-ember vagy egy kész AI-kreátor minden csomagban működik.

Mennyi ideig tart?

A hossztól függ: rövid klipnél percekig, hosszabbnál vagy új hanggal tovább. A hívás azonnal egy feladattal válaszol, te pedig ellenőrzöd, vagy egy általad választott linkre megkapod a kész videót.

Személy helyett tárgyat is módosíthatok?

Igen. Az edits végpont egy egyszerű utasítás alapján egyetlen dolgot változtat meg egy klipben, például egy bögre színét, vagy lecserél egy üveget a termékedre, minden mást pedig érintetlenül hagy.