视频与素材

获取素材组

通过素材组 ID 获取一个 Seedance 素材组。

GET
/v1/videos/assets/groups/{groupId}

获取素材组及其类型和状态。library_type 用于区分虚拟人物与真人素材组。

只有状态为 ACTIVE 的素材组可以接收新素材。

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

请求示例

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

响应示例

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Product references",
  "description": "Reusable product shots",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/groups/group-20260720123456-vrt01"
{  "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}

授权

BearerAuth
AuthorizationBearer <token>

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

位置: header

路径参数

groupId*string

查询参数

project_name?string

素材资源的项目范围。

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

响应

application/json

application/json

application/json

application/json

application/json