API motion transfer: đưa một người mới vào bất kỳ video nào

Bạn có một video hiệu quả. Giờ bạn muốn có nó với một người khác trong đó: creator của chính bạn, một khách hàng, hoặc một người chưa hề tồn tại. Hermoso API làm điều đó chỉ trong một yêu cầu. Gửi video và người cần đưa vào, người mới sẽ thực hiện mọi động tác, biểu cảm và khẩu hình của bản gốc, trên cùng nhịp và cùng điểm cắt, trong cùng căn phòng và ánh sáng. Âm thanh gốc được giữ nguyên.

Đọc tài liệu API →

Một lệnh gọi trông như thế nào?

Gửi video và người nên có mặt trong đó. Với "dry_run": true thì không có gì chạy, và câu trả lời là mức giá chính xác.

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

Gửi cùng yêu cầu đó mà không có "dry_run": true và nó sẽ bắt đầu. Bạn nhận lại một job ngay lập tức, và video hoàn chỉnh khi xong: vài phút cho clip ngắn, lâu hơn cho clip dài.

Bạn có thể đưa ai vào video?

• Creator bạn đã lưu, hoặc một trong các creator AI có sẵn, theo id.
• Một tấm ảnh của người đó, qua link.
• Một người AI từ lời mô tả của bạn. Mô tả họ (tuổi, tóc, phong cách, thần thái) và Hermoso tạo ra họ trước, rồi đưa họ vào video. Họ được lưu vào Library của bạn, nên bạn có thể dùng lại.

Muốn họ có giọng khác nữa? Thêm một giọng mới với cùng lời thoại và nhịp, hoặc để họ nói một ngôn ngữ khác với khẩu hình khớp với lời mới. Vẫn là cùng một yêu cầu và cùng một job.

Những video nào dùng được?

Một link TikTok, Reel, Facebook, X hoặc YouTube, một link tới file video, hoặc file bạn đã tải lên Hermoso. Một lệnh gọi xử lý tối đa 60 giây, và bạn có thể chọn một đoạn bằng điểm bắt đầu và điểm kết thúc.

Chi phí là bao nhiêu?

Tùy vào độ dài video và việc bạn có thêm giọng mới hay không, nên chúng tôi không bao giờ đoán. Một dry run cho bạn mức giá chính xác, từng bước một, trước khi bất cứ thứ gì chạy. Lệnh gọi thật sẽ giữ trước số đó và chỉ tính đúng chi phí thực của lần render, không bao giờ hơn. Xem bảng giá để biết một credit có giá trị bao nhiêu.

Có thể đổi một đồ vật thay vì một người không?

Có. Endpoint thứ hai đổi một thứ trong clip từ một câu lệnh đơn giản: "chỉ đổi chiếc cốc sang màu đỏ", "thay chai bằng sản phẩm của chúng tôi", "chuyển thành ban đêm". Chuyển động, nhịp và khung hình được giữ nguyên. Thêm ảnh của sản phẩm hoặc chất liệu thật và thay đổi sẽ khớp với nó.

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

Chưa chắc kết quả trông ra sao? Hãy xem trước một khung hình tĩnh. Bạn thấy thay đổi trên một khung hình, kèm giá của cả clip bên cạnh, và clip chỉ chạy khi bạn đồng ý.

Xây dựng cho backend của bạn

• Async. Một lệnh gọi thật trả lời ngay bằng một job. Kiểm tra job, hoặc đưa chúng tôi một link và chúng tôi gửi video hoàn chỉnh cho bạn.
• Thử lại an toàn. Gửi lại cùng idempotency key và bạn nhận lại đúng job đó, không bao giờ render lần hai.
• Từ chối rõ ràng. Khi có gì đó không chạy được, bạn biết lý do trước khi bị tính phí, kèm một mã để code của bạn rẽ nhánh.
• Một API key từ ứng dụng, chính là key mà MCP server và dòng lệnh dùng.

Còn người thật thì sao?

Ảnh của một người thật cần gói trả phí, và việc gửi ảnh xác nhận bạn đã được họ cho phép. Một người AI từ lời mô tả của bạn, hoặc một creator AI có sẵn, dùng được trên mọi gói. Các yêu cầu đưa ai đó vào một cảnh mà họ không bao giờ nên xuất hiện sẽ bị từ chối trước khi bất cứ thứ gì chạy.

Thích bấm hơn là viết code?

Tính năng đổi người tương tự có trong ứng dụng, tại đổi người trong video, và AI agent của bạn có thể chạy nó qua MCP. Cả ba đều dùng cùng một engine và có cùng chi phí.

Câu hỏi thường gặp

API motion transfer là gì?

Nó nhận một video và một người khác, rồi trả về video có người đó trong đó, làm đúng những gì người gốc đã làm: cùng động tác, biểu cảm, nhịp và điểm cắt. Phiên bản của Hermoso còn giữ âm thanh gốc và có thể cho người mới một giọng nói hoặc ngôn ngữ mới.

Một lần thay người trong video tốn bao nhiêu?

Tùy vào độ dài video và việc bạn có thêm giọng mới hay không. Gửi yêu cầu với dry_run và bạn nhận được mức giá chính xác trước khi bất cứ thứ gì chạy. Lệnh gọi thật không bao giờ tính phí nhiều hơn mức đó.

Tôi có thể dùng ảnh của người thật không?

Có, trên gói trả phí, và chỉ khi được người đó cho phép. Việc gửi ảnh xác nhận bạn đã có sự cho phép đó. Một người AI tạo từ mô tả, hoặc một creator AI có sẵn, dùng được trên mọi gói.

Mất bao lâu?

Tùy vào độ dài: vài phút cho clip ngắn, lâu hơn cho clip dài hoặc clip có giọng mới. Lệnh gọi trả lời ngay bằng một job, và bạn tự kiểm tra hoặc nhận video hoàn chỉnh gửi tới link bạn chọn.

Tôi có thể đổi một đồ vật thay vì một người không?

Có. Endpoint edits đổi một thứ trong clip từ một câu lệnh đơn giản, như đổi màu chiếc cốc hoặc thay chai bằng sản phẩm của bạn, và giữ mọi thứ khác như cũ.