Tác giả: 
Bạn đã thấy xu hướng video AI hoán đổi khuôn mặt ở khắp nơi — bạn bè xuất hiện trong các cảnh phim, nhà sáng tạo tự đóng mọi nhân vật trong tiểu phẩm của chính họ, thương hiệu thay người dẫn mà không cần quay lại. Rất vui. Nhưng đây là phiên bản không ai nói với bạn: điều gì xảy ra nếu bạn có thể dùng một video và tạo ra mười phiên bản khác nhau, mỗi phiên bản với một khuôn mặt khác nhau, tất cả trong một lượt xử lý, bằng một công cụ chạy riêng tư trên chính máy tính của bạn?
Đó chính xác là những gì chúng ta sẽ xây dựng hôm nay, sử dụng YouCam AI Video Face Swap API và Claude. Không cần kỹ năng lập trình. Không cần tải video của bạn lên một website bí ẩn nào đó. Một đoạn prompt, một khóa API miễn phí, và bạn đã có cỗ máy hoán đổi khuôn mặt hàng loạt của riêng mình.
Ba bước. Bắt đầu nhé.
Bạn cần chuẩn bị gì trước khi bắt đầu
- Claude Cowork: ứng dụng không gian làm việc tác vụ (agentic workspace) của Anthropic. Nó sẽ xây dựng công cụ cho bạn.
- Một khóa API YouCam: đăng ký miễn phí, và bạn nhận được 40 tín dụng miễn phí để bắt đầu hoán đổi ngay lập tức.
- Một video mục tiêu: video có khuôn mặt sẽ bị thay thế.
- Một vài ảnh khuôn mặt: các khuôn mặt bạn muốn hoán đổi vào, tối đa 10 khuôn mặt mỗi lần. Mỗi khuôn mặt tạo ra một video hoán đổi riêng.
Chỉ vậy thôi. Không cần phần mềm chỉnh sửa, không có watermark từ các công cụ freemium ngẫu nhiên.
Bước 1: Yêu cầu Claude xây dựng công cụ video hoán đổi khuôn mặt cho bạn
Mở Claude Cowork và dán prompt bên dưới vào. Claude sẽ xây dựng một công cụ web cục bộ nhỏ, cho phép bạn tải lên một video, thêm nhiều ảnh khuôn mặt, và nó sẽ chạy một quy trình AI hoán đổi khuôn mặt riêng cho từng khuôn mặt với cùng một video, hiển thị kết quả ngay khi xử lý xong.
Đây là prompt — hãy sao chép toàn bộ:
Tôi muốn bạn xây cho tôi một công cụ cục bộ sử dụng API "AI Video Face Swap" (face-swap-vid) của YouCam từ Perfect Corp để hoán đổi một khuôn mặt vào một video đích. Tôi đã có khóa API YouCam và sẽ dán nó vào giao diện của công cụ — đừng hỏi tôi khóa trong đoạn yêu cầu này.
Yêu cầu chức năng
* Xây một giao diện web (chạy cục bộ) nơi tôi có thể:
* Tải lên MỘT video đích (video có khuôn mặt sẽ bị thay thế). Hiển thị trình phát xem trước và tự động đọc độ dài video sau khi tải xong.
* Tải lên ĐỒNG THỜI NHIỀU ảnh khuôn mặt tham chiếu (tối đa 10), có hình thu nhỏ xem trước, và xóa bất kỳ ảnh nào trong số đó trước khi gửi.
* Đặt độ dài đầu ra tính theo giây (dst_duration), được điền sẵn tự động dựa trên độ dài thực tế của video đã tải lên (làm tròn lên, giới hạn 30 giây), và tôi có thể chỉnh sửa.
* Bấm một nút để chạy toàn bộ batch. Với mỗi ảnh khuôn mặt tham chiếu, chạy một tác vụ hoán đổi khuôn mặt riêng biệt với CÙNG video đích — tái sử dụng duy nhất một lần tải video, không tải lại video cho từng khuôn mặt.
* Hiển thị kết quả ngay khi hoàn thành. Đừng bắt tôi chờ tác vụ chậm nhất trước khi thấy kết quả đầu tiên — mỗi khuôn mặt là một thẻ: hình thu nhỏ của khuôn mặt, một vòng quay chờ trong lúc xử lý, sau đó là video kết quả đã hoán đổi (phát trực tiếp trong trang) cùng với một liên kết để mở ở kích thước đầy đủ. Nếu một ca hoán đổi khuôn mặt bị lỗi, chỉ thẻ đó hiển thị lỗi; phần còn lại của batch vẫn tiếp tục chạy.
Các thông tin kỹ thuật về API này bạn cần biết
* Base URL: https://yce-api-01.makeupar.com
* Xác thực: API V2 — chỉ cần "Authorization: Bearer YOUR_API_KEY" trên mọi request, không có cuộc gọi trao đổi token riêng.
* Quy trình tải tệp: POST /s2s/v2.0/file/face-swap-vid với body { "files": [{ "content_type", "file_name", "file_size" }] }. Cùng một endpoint này được dùng để đăng ký CẢ video đích và từng ảnh khuôn mặt tham chiếu — chỉ cần gọi một lần cho mỗi tệp với content_type phù hợp ("video/mp4" hoặc "image/jpeg" chẳng hạn). Phản hồi chứa một file_id cùng một URL tải lên presigned (requests[0].url / requests[0].method) — gọi endpoint này KHÔNG tải tệp lên; bạn phải PUT riêng phần byte thô của tệp vào URL đó. Đừng chuyển tiếp header Content-Length trong lệnh PUT đó; để HTTP client tự đặt, nếu không việc tải lên sẽ thất bại. Cấu trúc JSON chính xác của file_id / requests có thể thay đổi tùy phiên bản tài liệu, vì vậy hãy phân tích phản hồi đăng ký một cách phòng thủ (tìm đệ quy các khóa này) thay vì giả định một cấu trúc cố định.
* Giới hạn tệp: video đích không được vượt quá 30 giây, độ phân giải 4K hoặc 30 FPS; định dạng chứa là mov/mp4; kích thước tệp tối đa 100 MB. API này chỉ hỗ trợ video với một khuôn mặt duy nhất.
* Tạo tác vụ: POST /s2s/v2.0/task/face-swap-vid với body { "src_file_id": <video file_id>, "ref_file_id": <face file_id>, "dst_duration": <seconds> } → trả về { "data": { "task_id" } }.
* Polling: GET /s2s/v2.0/task/face-swap-vid/{task_id} → kiểm tra trạng thái tác vụ. Các phiên bản tài liệu không nhất quán ở đây — đôi khi kết quả xuất hiện dưới dạng một url ở mức top-level sau khi xong mà không có trường status rõ ràng, đôi khi nó được lồng dưới data.task_status / data.results.url giống các API tác vụ YouCam khác. Hãy phân tích một cách phòng thủ: coi việc tìm thấy URL kết quả là thành công; nếu không thì tìm một trường task_status rõ ràng (running / success / error), mặc định là running nếu chưa thấy gì.
* Giới hạn tốc độ: khoảng 250 request / 300 giây cho mỗi khóa API. Khi tải lên / tạo tác vụ cho nhiều khuôn mặt trong một batch, hãy giới hạn mức song song (ví dụ 3 tác vụ cùng lúc) thay vì bắn tất cả cùng một lúc.
* Đây là API server-to-server. Gọi trực tiếp từ JavaScript trên trình duyệt sẽ bị lỗi CORS ("Failed to fetch"). Hãy xây một server Node.js/Express nhỏ chạy cục bộ giữ khóa API và proxy mọi cuộc gọi tới Perfect Corp ở phía server. Giao diện trình duyệt chỉ được nói chuyện với server cục bộ này (ví dụ http://localhost:3939), không bao giờ gọi trực tiếp tới yce-api-01.makeupar.com.
* Khóa API không bao giờ được ghi xuống đĩa. Trên trình duyệt, giữ nó trong một biến JS thông thường (lấy từ ô nhập trong UI) và gửi nó trong mỗi request tới server cục bộ thông qua một header tùy chỉnh (ví dụ X-YCE-API-Key); server cục bộ đọc header này cho từng request và chuyển tiếp nó thành "Authorization: Bearer <key>" khi gọi lên upstream. Đừng ghi khóa vào file cấu hình, file env, và cũng đừng log nó.
Nguyên tắc triển khai UI (tránh một lỗi đã biết)
* Với mỗi hành động tải tệp ("bấm để tải video" / "bấm để tải ảnh khuôn mặt"), gắn hành vi bấm-để-mở-hộp-thoại-chọn-tệp CHÍNH XÁC MỘT LẦN. Một lỗi phổ biến: bọc <input type="file"> ẩn trong một thẻ <label> VÀ đồng thời gọi input.click() từ một trình xử lý click JS trên chính label đó. Hành vi chuyển tiếp click nguyên bản của label cộng với lời gọi .click() thủ công sẽ kích hoạt hộp thoại chọn tệp hai lần cho mỗi lần bấm, và trong hầu hết trình duyệt, lời gọi thứ hai sẽ hủy hộp thoại mà lần đầu vừa mở — nên khi bấm dường như không có gì xảy ra, cũng không có lỗi. Hãy dùng một vùng chứa không phải <label> (ví dụ <div role="button" tabindex="0">) làm khu vực thả/bấm, và kích hoạt input file thông qua một trình xử lý click JS duy nhất (cộng với trình xử lý keydown cho Enter/Space để vẫn hỗ trợ bàn phím).
Yêu cầu bàn giao / đóng gói
* Node.js + Express + multer thuần. Không build step, không framework frontend.
* Frontend HTML/CSS/JS một trang, được phục vụ như static file bởi cùng server Express (cùng origin, vì vậy không cần cấu hình CORS trên chính server).
* Bao gồm một package.json với các dependency.
* Bao gồm file khởi chạy double-click cho CẢ macOS và Windows: một file .command cho macOS và một file .bat cho Windows. Mỗi file cần:
* cd vào chính thư mục của nó,
* chạy npm install chỉ khi chưa có node_modules,
* tự động mở http://localhost:3939 trong trình duyệt sau một khoảng trễ ngắn,
* sau đó chạy npm start.
Khi chạy npm install, trỏ nó tới một thư mục cache cục bộ của dự án (--cache "$(pwd)/.npm-cache" trên Mac, --cache "%cd%\\.npm-cache" trên Windows) thay vì cache npm toàn cục — một số máy có cache npm toàn cục bị hỏng hoặc lỗi quyền gây lỗi cài đặt, và cách này giúp tránh hoàn toàn lỗi đó.
* Tự kiểm thử logic server trước khi bàn giao cho tôi — xác minh các request tải tệp / tạo tác vụ / polling thực sự chạy được với API thật. Nếu tôi chưa đưa khóa thật cho bạn, hãy kiểm thử với một khóa cố ý sai và xác nhận bạn nhận được phản hồi 401 như mong đợi ở mỗi bước, để chúng ta biết các endpoint và payload đã được nối đúng.
* Đồng thời kiểm tra nhanh giao diện upload của frontend (ví dụ xác nhận mỗi khu vực tải tệp chỉ có đúng một binding click-to-file-picker, theo nguyên tắc ở trên) thay vì chỉ kiểm thử các route trên server.Claude sẽ xây dựng công cụ, kiểm thử kết nối API và trả lại cho bạn một thư mục. Nhấp đúp vào start-mac.command (Mac) hoặc start-windows.bat (Windows), và studio hoán đổi khuôn mặt của bạn sẽ mở tại localhost:3939.
Bước 2: Lấy khóa API YouCam miễn phí (và 40 credit miễn phí)
Công cụ chạy trên cùng động cơ YouCam AI Video Face Swap dùng cho hoán đổi khuôn mặt video trực tuyến của YouCam. Để sử dụng, hãy truy cập trang YouCam AI API, đăng ký và nhận 40 credit miễn phí — chúng là của bạn ngay khi bạn đăng ký.
Sao chép khóa API của bạn từ bảng điều khiển. Công cụ không bao giờ lưu khóa này, nó chỉ tồn tại trong phiên trình duyệt của bạn và được gửi an toàn với từng yêu cầu. Không ghi xuống ổ đĩa, không ghi log, không nằm trong tầm với của bất kỳ ai ngoài bạn.
Bước 3: Một video đầu vào, mười bản hoán đổi khuôn mặt đầu ra
Quay lại công cụ cục bộ của bạn:
- Dán khóa API của bạn ở phía trên cùng.
- Tải lên video mục tiêu của bạn — công cụ sẽ hiển thị bản xem trước và tự động điền thời lượng đầu ra cho bạn.
- Thêm tối đa 10 ảnh khuôn mặt. Ảnh thu nhỏ sẽ xuất hiện; xóa bất kỳ ảnh nào nếu bạn đổi ý.
- Nhấp nút. Mỗi khuôn mặt có thẻ riêng với vòng quay tải, sau đó là bản hoán đổi hoàn chỉnh — có thể phát ngay tại đó, với liên kết kích thước đầy đủ. Ba bản hoán đổi được xử lý cùng lúc và nếu một bản lỗi, các bản còn lại vẫn tiếp tục.
Đây là lúc sức mạnh xử lý theo lô phát huy tác dụng. Đang thử xem gương mặt của nhà sáng tạo nội dung nào hiệu quả nhất trong một mẫu quảng cáo? Tạo clip cá nhân hóa cho mọi người trong nhóm trò chuyện của bạn? Bản địa hóa một video với các người dẫn khác nhau? Tất cả chỉ bằng một lần nhấp thay vì mười phiên chỉnh sửa riêng lẻ.
Loại video nào phù hợp nhất cho hoán đổi khuôn mặt bằng AI?
Một vài nguyên tắc cơ bản để AI có thể hoạt động hiệu quả nhất:
| Yêu cầu | Thông số lý tưởng |
|---|---|
| Độ dài video | Tối đa 30 giây |
| Định dạng | MP4 hoặc MOV, tối đa 100MB |
| Độ phân giải / tốc độ khung hình | Tối đa 4K, tối đa 30 FPS |
| Khuôn mặt trong video | Chính xác một chủ thể rõ nét, nhìn thẳng — không hỗ trợ video có nhiều người |
| Ảnh khuôn mặt | Rõ nét, đủ sáng, nhìn thẳng, không có gì che mặt |
Còn một điều nữa, và khá quan trọng: hãy hoán đổi một cách có trách nhiệm. Chỉ sử dụng video mà bạn có quyền sử dụng và khuôn mặt mà bạn có sự cho phép.
Hoán đổi khuôn mặt được dùng cho sáng tạo nội dung, tiểu phẩm, chiến dịch, nội dung do người hâm mộ tạo ra có sự đồng ý, không phải cho giả mạo hay lừa dối.
Nhiều nền tảng hiện yêu cầu nhà sáng tạo gắn nhãn nội dung tạo bởi AI, và sự minh bạch đó cũng có lợi cho thương hiệu của bạn.
Tại sao xây dựng bằng YouCam API thay vì dùng một công cụ miễn phí ngẫu nhiên?
Câu hỏi hợp lý. Các trang web hoán đổi khuôn mặt miễn phí có ở khắp nơi. Nhưng cách tiếp cận này đem lại cho bạn những thứ mà chúng không có:
- Xử lý theo lô ngay từ thiết kế. Mười khuôn mặt cho một video trong một lần chạy — hầu hết công cụ miễn phí bắt bạn thực hiện từng lần hoán đổi riêng lẻ.
- Quyền riêng tư được đảm bảo từ kiến trúc. Công cụ chạy cục bộ và giao tiếp trực tiếp với API của YouCam. Không có trang web bên thứ ba giữ video của bạn làm con tin sau tường trả phí.
- Lộ trình đưa vào sản phẩm thực tế. Đây là cùng API cho nhà phát triển mà bạn sẽ dùng để tích hợp tính năng hoán đổi khuôn mặt vào chính ứng dụng hoặc quy trình chiến dịch của bạn. Hôm nay là công cụ desktop; ngày mai là tính năng bạn tung ra thị trường.
Nó cũng kết hợp rất tốt với các thành phần khác trong bộ YouCam AI; chúng tôi đã trình bày cùng một mẫu Claude-kết-hợp-API với phân tích da.
Sẵn sàng thực hiện lần hoán đổi đầu tiên? Đăng ký YouCam AI API, nhận 40 credit miễn phí và bạn sẽ có một loạt video hoán đổi khuôn mặt trước giờ ăn trưa.
Câu hỏi thường gặp: video AI hoán đổi khuôn mặt với YouCam & Claude
Video AI hoán đổi khuôn mặt là gì?
Đó là khi AI thay thế một khuôn mặt trong video bằng một khuôn mặt khác, từng khung hình một, đồng thời giữ lại biểu cảm, chuyển động đầu và ánh sáng gốc để kết quả trông tự nhiên chứ không bị dán lên. API hoán-đổi-khuôn-mặt-trong-video của YouCam tự động xử lý việc theo dõi và hòa trộn.
API YouCam AI Video Face Swap có miễn phí dùng thử không?
Có — bạn nhận được 40 credit miễn phí khi đăng ký, đủ để chạy lô hoán đổi đầu tiên và tự đánh giá chất lượng. Sau đó là mô hình trả phí theo mức sử dụng.
Tôi có thể hoán đổi nhiều khuôn mặt cùng lúc không?
Có và không, và sự khác biệt này rất quan trọng. Bản thân video đích phải chứa chỉ một khuôn mặt; API này không hoán đổi nhiều người trong cùng một video. Công cụ xử lý theo lô sẽ chạy tối đa 10 lần hoán đổi riêng biệt với cùng một video chỉ có một khuôn mặt đó, mỗi lần một khuôn mặt mới, một video hoàn chỉnh cho mỗi khuôn mặt. Tóm lại: một khuôn mặt trong video, xuất ra mười phiên bản khác nhau.
Một video hoán đổi khuôn mặt mất bao lâu?
Mỗi lần hoán đổi thường hoàn thành trong chưa đến một phút đối với các đoạn clip ngắn, và công cụ xử lý ba video cùng lúc, vì vậy một lô đầy đủ 10 video không mất thời gian gấp 10 lần.
Nội dung của tôi có an toàn không?
Công cụ chạy trên chính máy của bạn và khóa API của bạn không bao giờ được ghi vào ổ đĩa hoặc ghi log. Tệp tải lên được gửi thẳng đến API bảo mật của YouCam — không có trang web bên thứ ba nào ở giữa.
Việc hoán đổi khuôn mặt có hợp pháp không?
Việc dùng nội dung của chính bạn, hoặc nội dung bạn có quyền sử dụng, cho mục đích sáng tạo — là hợp lệ. Mạo danh người thật để lừa đảo, quấy rối hoặc lừa dối là không chấp nhận được (và không được phép). Khi chia sẻ công khai, hãy gắn nhãn nội dung do AI tạo ra ở những nơi nền tảng yêu cầu.
Nếu tôi gặp khó khăn thì sao?
Hãy liên hệ — liên hệ đội ngũ Perfect Corp và chúng tôi sẽ giúp bạn triển khai quy trình hoán đổi khuôn mặt.
