查询素材列表

GET /api/volc-user/assets

分页查询当前用户的素材列表，支持按素材组、状态、名称筛选与排序。

鉴权说明

用户控制台接口，需登录用户身份（会话 Cookie，或 Authorization: <access_token>，令牌由 生成访问令牌 获取）。此令牌与模型调用使用的 sk- 密钥不同。

Query 参数

参数名	类型	必选	说明
pageNumber	integer	可选	页码，从 1 开始，默认 1
pageSize	integer	可选	每页数量，默认 20，最大 100
assetStatus	integer	可选	平台素材状态：1 正常、2 禁用
statuses	integer[]	可选	火山状态列表：1 Active、2 Processing、3 Failed；支持重复参数或逗号分隔
groupIds	string[]	可选	素材组 ID 列表，支持重复参数或逗号分隔
groupType	string	必选	素材组类型，通常为 AIGC
projectName	string	可选	火山项目名
name	string	可选	按素材名称模糊搜索
sortBy	string	可选	排序字段：Id、CreateTime、UpdateTime、Name
sortOrder	string	可选	排序顺序：Asc 升序，其他值降序

请求示例

GET /api/volc-user/assets?pageNumber=1&pageSize=20&assetStatus=1&statuses=1&statuses=2&groupIds=group-7f2b8d9c&groupType=AIGC&name=模特&sortBy=CreateTime&sortOrder=Desc

响应字段（200）

字段名	类型	说明
success	boolean	是否成功
message	string	提示信息
data	object	分页对象
data.totalCount	integer	总数量
data.pageNumber	integer	当前页码
data.pageSize	integer	每页数量
data.items	array<object>	素材列表
data.items[].id	string	素材 ID
data.items[].name	string	素材名称
data.items[].url	string	火山返回的素材访问 URL（通常有 12 小时有效期）
data.items[].assetType	string	素材类型：Image、Video、Audio
data.items[].groupId	string	素材组 ID
data.items[].status	string	火山状态：Processing、Active、Failed
data.items[].projectName	string	火山项目名
data.items[].createTime	integer	创建时间（Unix 秒）
data.items[].updateTime	integer	更新时间（Unix 秒）
data.items[].error	object	失败信息（仅失败时返回）
data.items[].error.code	string	错误码
data.items[].error.message	string	错误描述
data.items[].remark	string	平台备注
data.items[].asset_status	integer	平台素材状态：1 正常、2 禁用

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "totalCount": 1,
    "pageNumber": 1,
    "pageSize": 20,
    "items": [
      {
        "id": "asset-a3c92f10",
        "name": "模特正面图",
        "url": "https://example-signed-url.volces.com/xxx",
        "assetType": "Image",
        "groupId": "group-7f2b8d9c",
        "status": "Active",
        "projectName": "default_project",
        "createTime": 1718000000,
        "updateTime": 1718000300,
        "remark": "第三方业务素材 ID: ext-10001",
        "asset_status": 1
      }
    ]
  }
}