获取资产

GET/v1/assets/{assetId}

获取资产。

身份验证

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

路径参数

assetIdstringrequired

资产 ID。

响应

codeinteger

响应状态码。

dataobject

资产详情对象。

data.assetIdstring

资产公共 ID。

data.sharedboolean

是否已共享给调用方。

data.sharePermissionstring

共享时的权限。

data.shareExpiresAtstring

共享到期时间（存在时）。

data.assetGroupIdstring

分组公共 ID。

data.groupNamestring

分组名称。

data.mediaTypestring

图片/视频/音频。

data.assetKindstring

资产类型。

data.sourceTypestring

来源类型。

data.statusstring

资产状态。

data.providerLastErrorobject

最近一次处理错误的稳定代码和通用提示（如有）。

data.namestring

资产名称。

data.filenamestring

原始文件名。

data.mimeTypestring

MIME 类型。

data.sizeBytesstring

文件大小（字节）。

data.fileTypestring

文件后缀/格式。

data.widthinteger

宽度（像素）。

data.heightinteger

高度（像素）。

data.aspectRatiostring

宽高比。

data.durationSecondsnumber

媒体时长（秒）。

data.frameRatenumber

视频帧率。

data.urlstring

访问链接。

data.thumbnailUrlstring

缩略图链接。

data.expiresAtstring

过期时间。

data.requestIdstring

生成链路中的请求 ID。

data.modelNamestring

生成模型名称。

data.modelTypestring

生成模型类型。

data.createdAtstring

创建时间。

data.updatedAtstring

更新时间。

msgstring

响应信息。

serviceCodestring | null

失败时的业务码。

请求

Shell

1curl https://api.token360.ai/v1/assets/{assetId} \
2  -H "Authorization: Bearer sk-your-api-key"

响应

JSON

1{
2  "code": 200,
3  "data": {
4    "assetId": "ua_1234567890abcdef",
5    "name": "avatar.png",
6    "mediaType": "image"
7  },
8  "msg": "success"
9}

托管资产配额与生命周期

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

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

此页面对您有帮助吗？