GET
/
v1
/
asset-groups
列出素材组
curl --request GET \
  --url https://api.novawander.cn/v1/asset-groups \
  --header 'Authorization: <authorization>'

​
简介

列出当前用户的素材组。用户只能查看和操作自己的素材组。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-xxxxxxxxxx

​
查询参数

​
group_type
string
默认值:"aigc"
aigc、liveness_face 或 all。未传时默认仅返回虚拟素材组——查看真人组请传 liveness_face 或 all

​
请求示例

# 默认：仅虚拟素材组
curl "https://api.novawander.cn/v1/asset-groups" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 仅真人素材组
curl "https://api.novawander.cn/v1/asset-groups?group_type=liveness_face" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 全部
curl "https://api.novawander.cn/v1/asset-groups?group_type=all" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

​
响应示例

{
  "groups": [
    {
      "group_id": "group-20260508120000-abcde",
      "group_type": "aigc",
      "name": "角色A",
      "description": "测试角色",
      "channel_id": 123,
      "space_label": "A",
      "asset_count": 3,
      "created_at": 1715140800,
      "updated_at": 1715140800
    }
  ],
  "total": 1,
  "has_byteplus_channels": true
}
字段说明
group_typeaigc 或 liveness_face
space_label多上游空间场景下的渠道标签（A / B / C…）
asset_count该组当前素材数量
has_byteplus_channels当前用户是否已配置 BytePlus 上游渠道