TokenLab

Video & tư liệu

Lấy Tài nguyên Vật liệu

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ó: PROCESSING, ACTIVE, FAILED, hoặc DELETED. Tài nguyên chỉ có thể được sử dụng để tạo video khi ready là true và status là ACTIVE. Khi quá trình xử lý thất bại, error_message sẽ cho biết lý do.

Nếu việc 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, chứ không phải group_id của vật liệu.

project_name phân loại các tài nguyên trong tổ chức của bạn và mặc định là default. Hãy sử dụng cùng một giá trị phân biệt chữ hoa chữ thường cho các nhóm và tài nguyên liên quan. Gửi giá trị này trong phần thân JSON đối với các yêu cầu POST/PUT và trong chuỗi truy vấn đối với các yêu cầu 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,
  "updated_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