API do transferu ruchu: wstaw nową osobę do dowolnego filmu

Masz film, który działa. Teraz chcesz go z kimś innym: z własnym twórcą, z klientem albo z osobą, która jeszcze nie istnieje. API Hermoso robi to w jednym żądaniu. Wyślij film i osobę, a nowa osoba wykona każdy ruch, minę i układ ust z oryginału, w tych samych rytmach i cięciach, w tym samym pomieszczeniu i świetle. Oryginalny dźwięk zostaje.

Przeczytaj dokumentację API →

Jak wygląda jedno wywołanie?

Wyślij film i informację, kto ma w nim być. Z "dry_run": true nic się nie uruchamia, a odpowiedzią jest dokładna cena.

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

Wyślij to samo żądanie bez "dry_run": true, a ruszy. Od razu dostajesz zadanie, a gotowy film wtedy, gdy będzie gotowy: minuty dla krótkiego klipu, dłużej dla długiego.

Kogo możesz wstawić do filmu?

• Twojego zapisanego twórcę albo jednego z gotowych twórców AI, po id.
• Zdjęcie tej osoby, przez link.
• Osobę AI z Twoich słów. Opisz ją (wiek, włosy, styl, klimat), a Hermoso najpierw ją stworzy, a potem wstawi. Trafi do Twojej Biblioteki, więc możesz jej użyć ponownie.

Chcesz, żeby ta osoba też brzmiała inaczej? Dodaj nowy głos z tymi samymi słowami i timingiem albo niech mówi w innym języku, z ustami dopasowanymi do nowych słów. To to samo żądanie i to samo zadanie.

Jakie filmy działają?

Link do TikTok, Reel, Facebook, X albo YouTube, link do pliku wideo albo plik przesłany do Hermoso. Jedno wywołanie obejmuje do 60 sekund, a fragment możesz wybrać, podając początek i koniec.

Ile to kosztuje?

To zależy od długości filmu i od tego, czy dodajesz nowy głos, więc nigdy nie zgadujemy. Uruchomienie próbne podaje dokładną cenę, krok po kroku, zanim cokolwiek ruszy. Prawdziwe wywołanie rezerwuje tę kwotę i rozlicza się według tego, ile render naprawdę kosztował, nigdy więcej. Zajrzyj do cennika, żeby sprawdzić, ile wart jest kredyt.

Czy zamiast osoby można podmienić przedmiot?

Tak. Drugi endpoint zmienia jedną rzecz w klipie na podstawie prostego polecenia: „zmień tylko kubek na czerwony”, „zamień butelkę na nasz produkt”, „zrób noc”. Ruch, timing i kadr zostają. Dodaj zdjęcie prawdziwego produktu albo materiału, a zmiana będzie do niego pasować.

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

Nie wiesz, jak to będzie wyglądać? Najpierw poproś o podgląd jednej klatki. Zobaczysz zmianę na pojedynczym kadrze, z ceną całego klipu obok, a klip ruszy dopiero wtedy, gdy dasz znać.

Stworzone dla Twojego backendu

• Asynchronicznie. Prawdziwe wywołanie od razu odpowiada zadaniem. Sprawdzaj zadanie albo podaj nam link, a wyślemy Ci gotowy film.
• Bezpieczne ponawianie. Wyślij ten sam klucz idempotencji jeszcze raz, a dostaniesz to samo zadanie, nigdy drugi render.
• Jasne odmowy. Gdy czegoś nie da się uruchomić, dowiesz się dlaczego, zanim cokolwiek zostanie pobrane, razem z kodem, na podstawie którego Twój kod może się rozgałęzić.
• Jeden klucz API z aplikacji, ten sam, którego używają serwer MCP i wiersz poleceń.

A co z prawdziwymi osobami?

Zdjęcie prawdziwej osoby wymaga płatnego planu, a wysyłając je, potwierdzasz, że masz jej zgodę. Osoba AI z Twoich słów albo gotowy twórca AI działają w każdym planie. Żądania, które umieściłyby kogoś w scenie, w której nigdy nie powinien się znaleźć, są odrzucane, zanim cokolwiek ruszy.

Wolisz klikać niż kodować?

Ta sama podmiana jest w aplikacji, w podmianie osoby w filmie, a Twój agent AI może ją uruchomić przez MCP. Wszystkie trzy drogi korzystają z tego samego silnika i kosztują tyle samo.

Najczęściej zadawane pytania

Czym jest API do transferu ruchu?

Bierze film i inną osobę, a zwraca film z tą osobą, która robi dokładnie to, co osoba z oryginału: te same ruchy, miny, timing i cięcia. Wersja Hermoso zachowuje też oryginalny dźwięk i może dać nowej osobie nowy głos albo język.

Ile kosztuje podmiana osoby?

To zależy od długości filmu i od tego, czy dodajesz nowy głos. Wyślij żądanie z dry_run, a dostaniesz dokładną cenę, zanim cokolwiek ruszy. Prawdziwe wywołanie nigdy nie pobierze więcej.

Czy mogę użyć zdjęcia prawdziwej osoby?

Tak, w płatnym planie i tylko za zgodą tej osoby. Wysyłając zdjęcie, potwierdzasz, że ją masz. Osoba AI stworzona z opisu albo gotowy twórca AI działają w każdym planie.

Ile to trwa?

To zależy od długości: minuty dla krótkiego klipu, dłużej dla długiego albo takiego z nowym głosem. Wywołanie od razu odpowiada zadaniem, a Ty je sprawdzasz albo dostajesz gotowy film na wybrany przez siebie link.

Czy mogę zmienić przedmiot zamiast osoby?

Tak. Endpoint edits zmienia jedną rzecz w klipie na podstawie prostego polecenia, na przykład kolor kubka albo butelkę na Twój produkt, a całą resztę zostawia bez zmian.