성과가 좋은 동영상이 있습니다. 이제 거기에 다른 사람을 넣고 싶습니다: 당신의 크리에이터, 고객, 또는 아직 존재하지 않는 사람. Hermoso API는 요청 한 번으로 이를 해냅니다. 동영상과 사람을 보내면, 새로운 사람이 원본의 모든 동작, 표정, 입 모양을 같은 박자와 컷에 맞춰, 같은 공간과 같은 조명 안에서 그대로 연기합니다. 원본 소리는 그대로 남습니다.
호출 한 번은 어떤 모습인가요?
동영상과 거기에 나올 사람을 보내세요. "dry_run": true을 붙이면 아무것도 실행되지 않고, 정확한 가격이 답으로 옵니다.
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
}'같은 요청을 "dry_run": true 없이 보내면 작업이 시작됩니다. 바로 작업(job)을 돌려받고, 완성된 동영상은 준비되는 대로 받습니다: 짧은 클립은 몇 분, 긴 클립은 더 걸립니다.
동영상에 누구를 넣을 수 있나요?
- 저장한 크리에이터, 또는 미리 준비된 AI 크리에이터 중 하나를 ID로 지정.
- 그 사람의 사진을 링크로 지정.
- 말로 만드는 AI 인물. 나이, 머리, 스타일, 분위기를 설명하면 Hermoso가 먼저 그 인물을 만들고, 그다음 동영상에 넣습니다. 인물은 라이브러리에 저장되니 다시 쓸 수 있습니다.
목소리도 바꾸고 싶나요? 같은 대사와 타이밍으로 새 목소리를 입히거나, 입 모양을 새 대사에 맞춰 다른 언어로 말하게 할 수 있습니다. 같은 요청, 같은 작업으로 됩니다.
어떤 동영상이 되나요?
TikTok, Reel, Facebook, X, YouTube 링크, 동영상 파일 링크, 또는 Hermoso에 업로드한 파일. 호출 한 번에 최대 60초까지 처리하며, 시작과 끝을 지정해 구간을 고를 수도 있습니다.
비용은 얼마인가요?
동영상 길이와 새 목소리를 넣는지에 따라 달라지기 때문에, 저희는 절대 짐작하지 않습니다. 드라이 런으로 아무것도 실행하기 전에 정확한 가격을 단계별로 확인할 수 있습니다. 실제 호출은 그 금액을 예약해 두고, 렌더링에 실제로 든 비용으로 정산합니다. 그보다 많이 청구되는 일은 없습니다. 크레딧의 가치는 요금제에서 확인하세요.
사람 대신 사물을 바꿀 수 있나요?
네. 두 번째 엔드포인트는 간단한 지시로 클립 속 한 가지를 바꿉니다: "머그컵만 빨간색으로 바꿔 줘", "병을 우리 상품으로 바꿔 줘", "밤으로 만들어 줘". 동작, 타이밍, 구도는 그대로입니다. 실제 상품이나 소재 사진을 함께 보내면 그에 맞게 바뀝니다.
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 }'어떻게 나올지 궁금한가요? 먼저 스틸 한 장 미리보기를 요청하세요. 한 프레임에서 변화를 보고, 옆에 전체 클립 가격도 함께 확인합니다. 클립은 당신이 말할 때만 실행됩니다.
백엔드를 위해 만들었습니다
- 비동기. 실제 호출은 바로 작업으로 답합니다. 작업을 확인하거나, 링크를 주시면 완성된 동영상을 보내 드립니다.
- 안전한 재시도. 같은 멱등성 키를 다시 보내면 같은 작업이 돌아오고, 두 번째 렌더링은 절대 일어나지 않습니다.
- 명확한 거절. 실행할 수 없을 때는 청구 전에 이유를 알려 드리며, 코드에서 분기할 수 있는 오류 코드도 함께 드립니다.
- API 키 하나로 충분합니다. 앱에서 만들며, MCP 서버와 명령줄에서도 같은 키를 씁니다.
실제 사람은 어떻게 되나요?
실제 사람의 사진은 유료 요금제가 필요하며, 사진을 보내면 그 사람의 허락을 받았다는 것을 확인하는 것입니다. 말로 만든 AI 인물이나 미리 준비된 AI 크리에이터는 모든 요금제에서 쓸 수 있습니다. 누군가를 절대 있어서는 안 될 장면에 넣으려는 요청은 아무것도 실행되기 전에 거절됩니다.
코드 대신 클릭으로 하고 싶나요?
같은 교체 기능은 앱의 동영상 속 인물 바꾸기에도 있고, AI 에이전트는 MCP로 실행할 수 있습니다. 세 가지 모두 같은 엔진으로 돌아가며 비용도 같습니다.
자주 묻는 질문
모션 트랜스퍼 API란 무엇인가요?
동영상과 다른 사람을 받아서, 그 사람이 원래 사람과 똑같이 행동하는 동영상을 돌려줍니다: 같은 동작, 표정, 타이밍, 컷. Hermoso의 버전은 원본 소리도 유지하고, 새로운 사람에게 새 목소리나 언어를 줄 수도 있습니다.
리캐스트 비용은 얼마인가요?
동영상 길이와 새 목소리를 넣는지에 따라 달라집니다. dry_run으로 요청을 보내면 아무것도 실행되기 전에 정확한 가격을 받습니다. 실제 호출은 그보다 많이 청구하지 않습니다.
실제 사람의 사진을 쓸 수 있나요?
네, 유료 요금제에서, 그리고 그 사람의 허락이 있을 때만 가능합니다. 사진을 보내면 허락을 받았다는 것을 확인하는 것입니다. 설명으로 만든 AI 인물이나 미리 준비된 AI 크리에이터는 모든 요금제에서 쓸 수 있습니다.
시간은 얼마나 걸리나요?
길이에 따라 다릅니다: 짧은 클립은 몇 분, 긴 클립이나 새 목소리를 넣은 클립은 더 걸립니다. 호출은 바로 작업으로 답하며, 그 작업을 확인하거나 원하는 링크로 완성된 동영상을 받을 수 있습니다.
사람 대신 사물을 바꿀 수 있나요?
네. edits 엔드포인트는 머그컵 색을 바꾸거나 병을 당신의 상품으로 바꾸는 것처럼 간단한 지시로 클립 속 한 가지를 바꾸고, 나머지는 그대로 둡니다.