列出资产

GET/v1/assets

列出当前用户的资产。

身份验证

Authorization Bearer — JWT 登录会话或 sk-* API Key。

查询参数

currentinteger

页码，默认 1。

sizeinteger

每页数量，默认 20，最大 100。

keywordstring

按资产名称或资产 ID 过滤。

assetKindstring

按资产类型过滤：USER_UPLOAD、AI_GENERATED、REAL_FACE 或 VIRTUAL_PORTRAIT。

sourceTypestring

按来源过滤：UPLOAD、AI_GENERATION 或 ASSET_LIFECYCLE。

mediaTypestring

按媒体类型过滤：IMAGE、VIDEO、AUDIO 或 OTHER。

statusstring

按状态过滤。

createdBystring

按当前可访问范围内的创建者姓名、用户名或邮箱过滤。

usedModelstring

按生成模型过滤。

createdFromstring

按创建时间起始范围（ISO-8601）。

createdTostring

按创建时间结束范围（ISO-8601）。

groupIdstring

按资产分组 ID 过滤。

响应

codeinteger

响应状态码。

dataobject

分页资产列表响应。

data.paginationobject

分页信息。

data.listarray

资产记录。

msgstring

响应信息。

serviceCodestring | null

失败时的业务码。

请求

Shell

1curl "https://api.token360.ai/v1/assets?current=1&size=20" \
2  -H "Authorization: Bearer sk-your-api-key"

响应

JSON

1{
2  "code": 200,
3  "data": {
4    "pagination": {
5      "currentPage": "1",
6      "total": "1",
7      "totalPage": "1",
8      "pageSize": "20"
9    },
10    "list": [
11      {
12        "assetId": "ua_1234567890abcdef",
13        "name": "avatar.png",
14        "assetKind": "USER_UPLOAD",
15        "mediaType": "IMAGE"
16      }
17    ]
18  },
19  "msg": "success"
20}

托管资产配额与生命周期

Virtual Portrait 与 Real Face 上传共享当前个人或租户作用域的托管资产配额。请以查询资产配额返回的结果为准。当前个人作用域默认额度为 50,000，租户作用域默认额度为 500,000；实际配置可能不同。

客户端集成请仅使用 Token360 返回的公开 assetId 和 assetGroupId。

此页面对您有帮助吗？