Thư viện tư liệu nhân vật số Seedance
Sử dụng API Action nguyên bản để tạo, xác minh, tải lên và tham chiếu tư liệu nhân vật số Seedance.
Thư viện tư liệu nhân vật số Seedance quản lý tư liệu người thật và nhân vật ảo có thể được tham chiếu bởi Seedance 2.0 và Seedance 2.5. API nguyên bản giữ nguyên Action, Version cùng cấu trúc yêu cầu và phản hồi tương ứng, được gọi bằng API Key AGTCloud.
Chọn loại tư liệu
| Loại tư liệu | Cách tạo | Trường hợp sử dụng | Giới hạn chính |
|---|---|---|---|
| Nhân vật ảo (AIGC) | Tạo vùng chứa tư liệu trực tiếp rồi tải lên | Người dẫn chương trình ảo, nhân vật và tư liệu sản phẩm | URL tải lên phải truy cập được từ máy chủ |
| Người thật (LivenessFace) | Hoàn tất xác minh liveness khuôn mặt trước | Nhân vật số người thật và hình ảnh của chính người dùng | Tư liệu phải khớp với khuôn mặt đã được xác minh |
Quy trình tích hợp nhân vật ảo
Tạo vùng chứa tư liệu
Gọi CreateAssetGroup để tạo nhóm tư liệu AIGC và lưu ID nhóm được trả về.
Tải tư liệu lên
Tải hình ảnh, video hoặc âm thanh có thể truy cập công khai lên nhóm tư liệu. Tải lên thành công chỉ cho biết yêu cầu đã được tiếp nhận; tư liệu thường chuyển sang trạng thái đang xử lý trước.
Chờ tư liệu sẵn sàng
Truy vấn định kỳ API truy vấn tư liệu cho đến khi trạng thái chuyển sang Active. Nếu chuyển sang Failed, hãy đọc thông tin lỗi và không tiếp tục sử dụng tư liệu đó.
Tham chiếu trong tác vụ video
Sử dụng asset://ASSET_ID hoặc asset://GROUP_ID làm URL tư liệu trong yêu cầu tạo tác vụ nguyên bản Seedance. Tư liệu được tham chiếu phải thuộc tài khoản hiện tại và ở trạng thái có thể sử dụng.
Quy trình tích hợp người thật
Với người thật, cần tạo phiên xác minh trước, hướng dẫn người dùng hoàn tất thu thập dữ liệu liveness trong trình duyệt trên điện thoại, rồi gọi GetVisualValidateResult để lấy ID nhóm tư liệu người thật; nếu phiên hết hiệu lực, cần tạo lại.
Sau khi lấy được nhóm tư liệu người thật, có thể tiếp tục tải tư liệu lên, nhưng khuôn mặt phải khớp với người đã được xác minh. Tư liệu không khớp sẽ chuyển sang trạng thái thất bại và trả về FaceMismatch.
Trạng thái tư liệu và kết quả
Processing: tư liệu vẫn đang xử lý; nên truy vấn mỗi khoảng 3 giây, không truy vấn liên tục mà không có khoảng nghỉ.Active: tư liệu có thể dùng để tạo video.Failed: đọc nguyên nhân lỗi và dừng truy vấn định kỳ; sửa tư liệu rồi tải lên lại.- URL có chữ ký do
GetAssettrả về có hiệu lực khoảng 11,5 giờ; không nên lưu làm URL cố định hoặc phân phối công khai.
Tư liệu được gắn với tài khoản sở hữu API Key. Khi truy cập tư liệu không tồn tại hoặc không thuộc tài khoản hiện tại, API có thể trả về ResourceNotFound. Xóa nhóm tư liệu sẽ đồng thời xóa các tư liệu trong nhóm; cần xác nhận ID đích và phạm vi xóa trước khi thao tác.
API liên quan
- Bắt đầu từ Tạo nhóm tư liệu hoặc Tạo phiên xác minh người thật.
- Khi tư liệu sẵn sàng, có thể chuyển đến Tạo video nguyên bản Seedance 2.5 hoặc Tạo video nguyên bản Seedance 2.0 để gửi tham chiếu
asset://....