更新资产

PATCH/v1/assets/{assetId}

更新资产。

身份验证

Authorization Bearer

在 Authorization 请求头中使用 API key 作为 bearer token。

路径参数

assetIdstringrequired

资产 ID。

请求体

namestring

可选展示名称。

groupIdstring

可选目标分组 ID。

statusstring

设置为 active 或 inactive。

expiresAtstring

可选 ISO-8601 过期时间。

响应

codeinteger

响应状态码。

dataobject

更新后的资产记录。

data.idinteger

内部资产 ID。

data.assetIdstring

资产公共 ID。

data.token360AssetIdstring

assetId 的兼容别名。

data.tenantIdinteger

租户 ID。

data.userIdinteger

所有者用户 ID。

data.userNamestring

所有者显示名。

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.sizeBytesinteger

文件大小（字节）。

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.byteplusAssetIdstring

BYTEPLUS 侧资产 ID。

data.providerRefsobject

提供商引用映射。

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","description":"Updated asset name"}'

响应

JSON

1{
2  "code": 0,
3  "data": {
4    "assetId": "asset_123",
5    "name": "avatar-renamed.png"
6  },
7  "msg": "Asset updated successfully"
8}

此页面对您有帮助吗？