Action material tương thích Volcengine

Các endpoint này hỗ trợ Action và trường tư liệu bên dưới, dùng xác thực Bearer TokenLab và cấu trúc ResponseMetadata + Result.

Endpoint và xác thựcCopy Anchor Link

POST https://api.tokenlab.sh/?Action=<ACTION>&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

Cũng hỗ trợ POST /api/v3?Action=<ACTION>&Version=2024-01-01. Mọi Action material chỉ nhận POST. Request chỉ có chữ ký AK/SK trả về 401 InvalidCredential.

ProjectName mặc định là default và là ranh giới cách ly thật trong tổ chức đã xác thực. Hãy dùng cùng giá trị cho các request liên quan.

Action nhóm materialCopy Anchor Link

CreateAssetGroup chỉ tạo nhóm AIGC. Nhóm LivenessFace được tạo sau khi xác minh người thật thành công; ListAssetGroups có thể lọc cả hai loại.

Tạo nhóm materialCopy Anchor Link

curl 'https://api.tokenlab.sh/?Action=CreateAssetGroup&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Name":"Product references","Description":"Reusable product shots","GroupType":"AIGC","ProjectName":"default"}'

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {"Id":"group-20260720123456-abc12"}
}

Action materialCopy Anchor Link

AssetType nhận Image, Video và Audio. Nhóm đích quyết định đây là material AIGC thông thường hay LivenessFace đã xác minh.

Sử dụng ID tư liệu TokenLab. CreateAsset trả về Result.Id trước khi xử lý xong; thăm dò GetAsset đến khi Result.Status là Active hoặc Failed. ListAssets cũng hỗ trợ SortBy: "GroupId".

Tạo materialCopy Anchor Link

curl 'https://api.tokenlab.sh/?Action=CreateAsset&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"GroupId":"group-20260720123456-abc12","URL":"https://example.com/reference.png","Name":"Front view","AssetType":"Image","ProjectName":"default"}'

Hành vi danh sáchCopy Anchor Link

PageNumber mặc định là 1; PageSize mặc định là 10 và tối đa 100. SortBy nhận CreateTime hoặc UpdateTime; SortOrder nhận Desc hoặc Asc.

Trạng thái material là Active, Processing và Failed. URL tạm thời từ GetAsset và ListAssets có hiệu lực 12 giờ. Hãy lưu Id làm định danh lâu dài.

ListAssetGroups và ListAssets trả tài nguyên trong Result.Items, cùng TotalCount, PageNumber và PageSize.

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {"Items":[],"TotalCount":0,"PageNumber":1,"PageSize":10}
}

Material người thậtCopy Anchor Link

Tạo phiên xác minh hình ảnh, hoàn tất xác minh H5, lấy GroupId, rồi gọi CreateAsset với nhóm đó. Upload được so khớp với khuôn mặt đã xác minh.

1. Tạo phiên xác minh hình ảnh
2. Lấy kết quả xác minh hình ảnh
3. Gọi CreateAsset với GroupId được trả về

LỗiCopy Anchor Link

Lỗi giữ envelope phản hồi Volcengine; mã và thông báo nằm trong ResponseMetadata.Error.

{
  "ResponseMetadata": {
    "RequestId": "req-id",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {"Code":"InvalidParameter","Message":"GroupId is required"}
  }
}

InvalidCredential, InvalidVersion, InvalidParameter, NotFound, Conflict, OperationDenied, MethodNotAllowed, InternalError.

Phương án RESTCopy Anchor Link

Các endpoint REST /v1/videos/assets* vẫn khả dụng. Tích hợp mới có thể chọn REST snake_case; client Volcengine hiện có không cần đổi body. Material Seedance và xác minh người thật.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}