Token360
登录注册

创建资产分组

POST/v1/asset-groups

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

使用 groupKind 选择分组类型。

身份验证

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

请求体

namestring

可选分组展示名称。

groupKindstring

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

emailstring

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

phonestring

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

defaultUploadTtlDaysinteger

GENERIC 分组中 USER_UPLOAD 资产的可选默认 TTL（1–3650 天）。

响应

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 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": 200,
3  "data": {
4    "assetGroupId": "your-asset-group-id",
5    "name": "Marketing Assets",
6    "groupKind": "GENERIC"
7  },
8  "msg": "success"
9}
此页面对您有帮助吗？
创建资产分组 · Token360