TokenLab

Video & tư liệu

Lấy tài nguyên vật liệu (Get Material Asset)

Truy xuất một tài nguyên vật liệu Seedance theo ID tài nguyên vật liệu TokenLab.

GET
/v1/videos/assets/{assetId}

Truy xuất một tài nguyên vật liệu và kiểm tra trạng thái xử lý của nó. Tài nguyên chỉ có thể được sử dụng để tạo video khi ready là true và status là ACTIVE.

Nếu quá trình tạo video trả về lỗi Seedance material asset not found or not accessible, hãy xác minh rằng bạn đã truyền đúng id của tài nguyên vật liệu này, thay vì group_id của vật liệu.

project_name tách biệt tài nguyên trong tổ chức đã xác thực. Mặc định là default; dùng cùng một giá trị phân biệt chữ hoa, chữ thường cho nhóm và tài nguyên liên quan. Gửi trong nội dung JSON với POST/PUT và tham số truy vấn với GET/DELETE.

Ví dụ yêu cầu

curl "https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Ví dụ phản hồi

{
  "id": "asset-20260720123456-qn7wr",
  "object": "seedance.material_asset",
  "project_name": "default",
  "group_id": "group-20260720123456-vrt01",
  "library_type": "aigc_avatar",
  "asset_name": "Front view",
  "asset_type": "Image",
  "status": "ACTIVE",
  "ready": true,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"
{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view",  "asset_type": "Image",  "status": "ACTIVE",  "ready": true,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số đường dẫn

assetId*string

Tham số truy vấn

project_name?string

Phạm vi dự án cho tài nguyên vật liệu.

Độ dài1 <= length <= 128
mặc định"default"

Phản hồi

application/json

application/json

application/json

application/json

application/json