更新资产分组

PATCH/v1/asset-groups/{groupId}

更新资产分组。

身份验证

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

路径参数

groupIdstringrequired

资产分组 ID。

status 仅支持 active 或 inactive。将分组设为 inactive 时，分组内资产也会变为不可用状态。

只有分组所有者可以调整成员。addAssetIds 和 removeAssetIds 仅支持可移动的普通资产（USER_UPLOAD 和 AI_GENERATED）；Real Face 和 Virtual Portrait 资产不能通过此接口移动。

请求体

namestring

可选展示名称。

statusstring

可选状态，例如 active 或 inactive。

addAssetIdsarray<string>

可选，要加入分组的资产 ID。

removeAssetIdsarray<string>

可选，要从分组移除的资产 ID。

响应

codeinteger

响应状态码。

dataobject

更新后的资产分组。

data.assetGroupIdstring

分组公共 ID。

data.sharedboolean

是否已共享给调用方。

data.sharePermissionstring

共享时的权限。

data.shareExpiresAtstring

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

data.namestring

分组名称。

data.groupKindstring

分组类型。

data.statusstring

分组状态。

data.verificationStatusstring

REAL_FACE 分组的验证状态（如适用）。

data.activationAllowedboolean

当前是否满足激活条件。

data.activationBlockedReasonstring

无法激活的原因（如适用）。

data.assetCountinteger

分组中的资产数量。

data.h5Linkstring

REAL_FACE 待验证分组的验证链接。

data.defaultUploadTtlDaysinteger

USER_UPLOAD 资源默认过期天数（配置后）。

data.createdAtstring

创建时间。

data.updatedAtstring

更新时间。

msgstring

响应信息。

serviceCodestring | null

失败时的业务码。

请求

Shell

1curl -X PATCH https://api.token360.ai/v1/asset-groups/{groupId} \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{"name":"Marketing Assets (renamed)"}'

响应

JSON

1{
2  "code": 200,
3  "data": {
4    "assetGroupId": "your-asset-group-id",
5    "name": "Marketing Assets (renamed)"
6  },
7  "msg": "success"
8}

托管资产配额与生命周期

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

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

此页面对您有帮助吗？