视频与素材

列出素材组

列出当前工作区的 Seedance 素材组。

GET
/v1/videos/assets/groups

列出当前工作区的素材组。可用 library_type 和 status 筛选虚拟人物或真人素材组。

上传素材时使用返回的 id;生成视频时使用具体素材的 id,不要传素材组 ID。

project_name 用于同一组织内的资源隔离,默认为 default。相关素材组和素材须使用相同且区分大小写的值;POST/PUT 在 JSON 请求体中传入,GET/DELETE 在查询参数中传入。

请求示例

curl "https://api.tokenlab.sh/v1/videos/assets/groups?library_type=aigc_avatar&page_size=20&project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

响应示例

{
  "groups": [
    {
      "id": "group-20260720123456-vrt01",
      "object": "seedance.material_asset_group",
      "project_name": "default",
      "library_type": "aigc_avatar",
      "group_name": "Product references",
      "status": "ACTIVE",
      "created_at": 1782998400000
    }
  ],
  "next_page_token": null
}
curl -X GET "https://example.com/v1/videos/assets/groups"
{  "groups": [    {      "id": "group-20260720123456-vrt01",      "object": "seedance.material_asset_group",      "library_type": "aigc_avatar",      "group_name": "Product references",      "description": "可复用的产品拍摄素材",      "status": "ACTIVE",      "metadata": null,      "created_at": 1782998400000    },    {      "id": "group-20260720123456-real1",      "object": "seedance.material_asset_group",      "library_type": "liveness_face",      "group_name": "Creator A",      "description": null,      "status": "ACTIVE",      "metadata": null,      "created_at": 1782998400000    }  ],  "next_page_token": null}

授权

BearerAuth
AuthorizationBearer <token>

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

位置: header

查询参数

page_size?integer
范围1 <= value <= 100
默认值20
page_token?string
status?string

可选值

  • "ACTIVE"
  • "DELETED"
library_type?string

按 TokenLab 材质库类别过滤。

可选值

  • "aigc_avatar"
  • "liveness_face"
project_name?string

素材资源的项目范围。

长度1 <= length <= 128
默认值"default"

响应

application/json

application/json

application/json

application/json