Cách sử dụng khuôn mặt thật trong Seedance 2.5 với tài nguyên người thật của AIHubMix

Video AI trở nên hữu ích hơn nhiều khi người xuất hiện trên màn hình vẫn có thể nhận ra từ cảnh này sang cảnh khác. Tài nguyên người thật của AIHubMix cung cấp một cách dựa trên sự đồng ý để sử dụng một khuôn mặt đã được phê duyệt trong quá trình tạo video Seedance, đồng thời tách biệt việc ủy quyền, xử lý tài nguyên và tạo video thành các bước riêng biệt, có thể kiểm chứng.

Hướng dẫn này giải thích video người thật là gì, quy trình của AIHubMix hoạt động ra sao, vì sao nó hữu ích và cách tạo video Seedance 2.5 từ một khuôn mặt thật. Bài viết cũng nêu rõ sự khác biệt giữa API Seedance 2.5 gốc và các tích hợp Seedance 2.0 tương thích.

Video người thật là gì?

Video người thật là video do AI tạo ra, sử dụng một người đã được ủy quyền làm tham chiếu danh tính. Mô hình có thể thay đổi bối cảnh, trang phục, hành động, chuyển động camera, giọng nói hoặc ngôn ngữ, đồng thời giữ được diện mạo nhận dạng được của người đó.

Điều này khác với việc tạo video từ văn bản thông thường. Một câu lệnh văn bản mô tả điều gì nên xảy ra, nhưng không thể xác định một người thật cụ thể một cách đáng tin cậy. Tài nguyên người thật cung cấp cho mô hình một tham chiếu hình ảnh đã được phê duyệt, có thể tái sử dụng trong nhiều video.

Các ứng dụng điển hình bao gồm avatar cho nhà sáng tạo nội dung, người thuyết trình ảo, video giới thiệu sản phẩm, chiến dịch bản địa hóa, video đào tạo, nhân vật thương hiệu và nội dung mạng xã hội ngắn.

Quy trình của AIHubMix hoạt động như thế nào

Quy trình gồm năm giai đoạn chính:

Tạo một nhóm tài nguyên cho một người.
Yêu cầu người trong ảnh hoàn tất quy trình ủy quyền.
Thêm ảnh chân dung và chờ cho đến khi tài nguyên ở trạng thái đang hoạt động.
Tham chiếu tài nguyên đang hoạt động bằng URI asset://.
Gửi tác vụ tạo video Seedance và truy vấn trạng thái cho đến khi hoàn thành.

Việc tách biệt này là có chủ đích. Việc ủy quyền diễn ra trước khi tạo video, tình trạng sẵn sàng của tài nguyên có thể được kiểm tra độc lập, và mọi giai đoạn quan trọng đều cung cấp một trạng thái để ứng dụng của bạn theo dõi.

Vì sao nên dùng AIHubMix?

Một API cho toàn bộ quy trình

AIHubMix cung cấp các endpoint cho nhóm tài nguyên, phiên xác minh, tài nguyên người thật và tạo video bất đồng bộ. Cùng một tài khoản và API key có thể quản lý toàn bộ quy trình.

Ủy quyền rõ ràng

Người có trong ảnh chân dung hoàn tất trang ủy quyền. Điều này tạo ra một bước đồng ý rõ ràng trước khi ảnh được dùng làm tham chiếu người thật có thể tái sử dụng.

Tài nguyên danh tính có thể tái sử dụng

Sau khi một ảnh trở nên hoạt động, ứng dụng có thể tái sử dụng ID tài nguyên của ảnh đó trong nhiều yêu cầu tạo video, thay vì tải lên ảnh gốc mỗi lần.

Tạo video sẵn sàng cho Seedance

Endpoint Seedance 2.5 gốc hỗ trợ tham chiếu văn bản, ảnh, video và âm thanh, cùng các tùy chọn về thời lượng, độ phân giải, tỷ lệ khung hình và tạo âm thanh.

Các trạng thái có thể quan sát, phù hợp với môi trường production

Ứng dụng của bạn có thể chờ verified, active và completed thay vì đoán xem một thao tác đã kết thúc hay chưa. Điều này giúp việc thử lại và xử lý lỗi dễ triển khai hơn.

Hướng dẫn từng bước

Bước 1: Chuẩn bị API key và ảnh chân dung

Tạo API key trong Bảng điều khiển AIHubMix. Hãy giữ kín khóa này. Trong Terminal, đặt nó làm biến môi trường:

export AIHUBMIX_API_KEY="your_api_key"

Chuẩn bị một URL HTTPS trực tiếp tới ảnh. URL phải trả về file ảnh mà không cần đăng nhập hoặc header tùy chỉnh, và phải luôn khả dụng trong suốt thời gian AIHubMix xử lý.

Yêu cầu ảnh được khuyến nghị:

JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC hoặc HEIF
Dưới 30 MB
Chiều rộng và chiều cao lớn hơn 300 pixel và nhỏ hơn 6000 pixel
Tỷ lệ khung hình lớn hơn 0.4 và nhỏ hơn 2.5
Ảnh chân dung rõ nét của cùng một người sẽ hoàn tất quy trình ủy quyền

Bước 2: Tạo nhóm tài nguyên người thật

Chạy lệnh này trong Terminal:

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My real-human asset"}'

Lưu lại id được trả về, có dạng ag_...:

GROUP_ID="ag_your_group_id"

Một nhóm mới thường bắt đầu với trạng thái pending_auth.

Bước 3: Tạo phiên ủy quyền

Sử dụng ID của nhóm để yêu cầu một phiên xác minh:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Phản hồi chứa một verification_url tạm thời. Mở URL đó trong trình duyệt và yêu cầu người trong ảnh chân dung xem lại mục đích rồi hoàn tất quy trình ủy quyền.

URL này nhạy cảm và chỉ có hiệu lực tạm thời. Không đăng công khai, không commit lên repository và không đưa vào ảnh chụp màn hình.

Bước 4: Xác minh ủy quyền và trạng thái nhóm

Sau khi người đó hoàn tất quy trình trên trình duyệt, hãy truy vấn cả hai tài nguyên:

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Chỉ tiếp tục khi phiên xác minh ở trạng thái verified và nhóm tài nguyên ở trạng thái active. Trang lỗi trên trình duyệt không quyết định kết quả cuối cùng; hãy dùng trạng thái từ API.

Bước 5: Thêm ảnh chân dung

Gửi URL trực tiếp của ảnh:

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

Lưu ID tài nguyên được trả về và truy vấn trạng thái của nó:

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

Chỉ sử dụng tài nguyên khi trạng thái của nó là active. creating và processing có nghĩa là tài nguyên chưa sẵn sàng.

Bước 6: Tạo video Seedance 2.5

Tài nguyên người thật phải được đặt trong input_references[].url. Không dán nó vào nội dung câu lệnh:

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

Phản hồi trả về một ID tác vụ video. Truy vấn GET /ai/v1/videos/{id} cho đến khi tác vụ ở trạng thái completed, sau đó tải video về sớm vì URL video chỉ có hiệu lực tạm thời.

Seedance 2.5 và Seedance 2.0

Seedance 2.5 sử dụng endpoint gốc /ai/v1/videos như đã mô tả ở trên. Các tích hợp cũ có thể dùng Seedance 2.0 với giao thức tương thích /v1/videos và cấu trúc nội dung khác.

Không trộn lẫn hai định dạng yêu cầu. Trước khi đưa vào sử dụng thực tế, hãy kiểm tra schema hiện hành của mô hình để xem các thời lượng, độ phân giải, loại tham chiếu, hành vi âm thanh và đường dẫn endpoint được hỗ trợ.

Các thực hành tốt nhất khi viết câu lệnh

Hãy mô tả bối cảnh, hành động, thời điểm, chuyển động camera, giọng nói và các ràng buộc. Một câu lệnh tốt có thể chỉ định kimono, hoa anh đào rơi, một cái vẫy tay nhẹ, lời thoại tiếng Nhật, chuyển động môi đồng bộ, chuyển động tóc tự nhiên và không có phụ đề.

Năm giây là đủ tốt cho một lời chào ngắn. Nếu video có nhiều hành động hoặc một câu dài, hãy dùng thời lượng dài hơn hoặc rút ngắn kịch bản để phần thể hiện không bị vội vàng.

Với một bài kiểm thử đơn giản, chỉ dùng một tham chiếu danh tính. Chỉ thêm tham chiếu bổ sung khi schema của mô hình hỗ trợ và mỗi tài nguyên thuộc cùng một nhóm tài nguyên.

Các vấn đề thường gặp

Nhóm chưa ở trạng thái đang hoạt động: chờ cho đến khi phiên xác minh chuyển sang verified và nhóm chuyển sang active.
Tài nguyên đang được xử lý: truy vấn trạng thái bằng ID tài nguyên gốc; không tạo bản sao bằng ID mới.
URL ảnh bị lỗi: dùng URL file HTTPS công khai, không dùng đường dẫn cục bộ, trang đăng nhập hoặc trang chia sẻ.
Video từ chối tài nguyên: xác nhận tài nguyên ở trạng thái active, thuộc cùng một tài khoản và sử dụng đúng loại media.
Playground không hiển thị asset://: tải ảnh lên Playground và đăng ký tài nguyên người thật là hai quy trình riêng biệt. Hãy dùng trường tham chiếu của API cho các tài nguyên đã đăng ký.

Danh sách kiểm tra cuối cùng

API key đã được cấu hình an toàn.
Đã tạo nhóm tài nguyên.
Đã hoàn tất ủy quyền của người đó.
Trạng thái nhóm là active.
Trạng thái tài nguyên ảnh chân dung là active.
Yêu cầu video sử dụng asset://<asset_id>.
Tác vụ video được truy vấn cho đến khi completed.

Tài nguyên người thật của AIHubMix mang đến cho nhà phát triển một cách thiết thực để xây dựng các trải nghiệm video dựa trên sự đồng ý và giữ nhất quán danh tính với Seedance. Hãy bắt đầu với một ảnh chân dung đã được phê duyệt và một đoạn video thử nghiệm ngắn, sau đó mở rộng cùng quy trình này sang các công cụ dành cho nhà sáng tạo, nội dung thương hiệu và ứng dụng production.