更新资产

PATCH/v1/assets/{assetId}

更新资产。

身份验证

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

路径参数

assetIdstringrequired

资产 ID。

groupId 仅可用于将普通 USER_UPLOAD 或 AI_GENERATED 资产移动到兼容分组。Real Face 和 Virtual Portrait 资产不能通过此接口移动。expiresAt 仅适用于支持过期时间的普通资产。

将 status 设为 active 时，资产所属分组必须处于 active 状态，且资产不能已过期。

请求体

namestring

可选展示名称。

groupIdstring

可选目标分组 ID。

statusstring

设置为 active 或 inactive。

expiresAtstring

可选 ISO-8601 过期时间。

响应

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 -X PATCH https://api.token360.ai/v1/assets/{assetId} \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{"name":"avatar-renamed.png"}'

响应

JSON

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

托管资产配额与生命周期

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

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

此页面对您有帮助吗？