创建资产分组

POST/v1/asset-groups

创建用于组织 Token360 资产的资产分组。

使用 groupKind 选择分组类型。

身份验证

Authorization Bearer

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

请求体

namestring

可选分组展示名称。

groupKindstring

可选分组类型：GENERIC、REAL_FACE 或 VIRTUAL_PORTRAIT。默认 GENERIC。

emailstring

REAL_FACE 分组中的可选联系邮箱。

phonestring

REAL_FACE 分组中的可选联系电话。

descriptionstring

可选分组描述。

defaultUploadTtlDaysinteger

适用于 GENERIC / GENERATED 分组的用户上传资产默认 TTL（天）。

响应

codeinteger

响应状态码。

dataobject

创建后的分组记录（`UnifiedAssetGroupVO`）。

data.idinteger

内部分组 ID。

data.assetGroupIdstring

分组公共 ID。

data.tenantIdinteger

租户 ID。

data.userIdinteger

所有者用户 ID。

data.userNamestring

所有者显示名。

data.sharedboolean

是否已共享给调用方。

data.sharePermissionstring

共享时的权限。

data.shareExpiresAtstring

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

data.namestring

分组名称。

data.groupKindstring

分组类型。

data.statusstring

分组状态。

data.assetCountinteger

分组中的资产数量。

data.h5Linkstring

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

data.defaultUploadTtlDaysinteger

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

data.createdAtstring

创建时间。

data.updatedAtstring

更新时间。

msgstring

响应信息。

serviceCodestring | null

失败时的业务码。

请求

Shell

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

响应

JSON

1{
2  "code": 0,
3  "data": {
4    "groupId": "group_456",
5    "name": "Marketing Assets",
6    "groupKind": "GENERIC"
7  },
8  "msg": "Asset group created"
9}

此页面对您有帮助吗？