素材组

CreateAssetGroup

创建素材组。

请求

curl -X POST 'https://ai.tuiwo.vip/ai?Action=CreateAssetGroup&Version=2024-01-01' \
  -H 'Authorization: Bearer $TUIWO_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "Name": "商品图片",
    "Description": "商品参考素材",
    "GroupType": "AIGC",
    "ProjectName": "default"
  }'

字段	类型	必填	说明
`Name`	string	是	素材组名称，最长 64 字符
`Description`	string	否	描述，最长 300 字符
`GroupType`	string	否	素材组类型，例如 `AIGC`、`LivenessFace`
`ProjectName`	string	否	项目名，默认 `default`

响应

{
  "Result": {
    "Id": "GROUP_ID"
  }
}

从 Result.Id 获取素材组 ID。

GetAssetGroup

查询单个素材组。

curl -X POST 'https://ai.tuiwo.vip/ai?Action=GetAssetGroup&Version=2024-01-01' \
  -H 'Authorization: Bearer $TUIWO_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"Id":"GROUP_ID"}'

字段	类型	必填	说明
`Id`	string	是	素材组 ID
`ProjectName`	string	否	默认 `default`

响应 Result：

字段	类型	说明
`Id`	string	素材组 ID
`Name`	string	名称
`Description`	string	描述
`GroupType`	string	组类型
`ProjectName`	string	项目名
`CreateTime`	string	创建时间
`UpdateTime`	string	更新时间

ListAssetGroups

分页查询素材组。

curl -X POST 'https://ai.tuiwo.vip/ai?Action=ListAssetGroups&Version=2024-01-01' \
  -H 'Authorization: Bearer $TUIWO_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"Filter":{"GroupType":"AIGC","Name":"商品"},"PageNumber":1,"PageSize":20}'

字段	类型	说明
`Filter.GroupType`	string	按组类型筛选
`Filter.GroupIds`	string[]	按组 ID 筛选
`Filter.Name`	string	按名称筛选
`NextToken`	string	游标分页标记
`MaxResults`	integer	游标分页大小，1–100
`SortBy`	string	`CreateTime` 或 `UpdateTime`
`SortOrder`	string	`Desc` 或 `Asc`
`PageNumber`	integer	页码分页
`PageSize`	integer	每页数量；平台当前默认上限约 50

响应 Result：

{
  "Items": [
    {
      "Id": "GROUP_ID",
      "Name": "商品图片",
      "Description": "商品参考素材",
      "GroupType": "AIGC",
      "ProjectName": "default",
      "CreateTime": "2026-11-09T12:00:00Z",
      "UpdateTime": "2026-11-09T12:00:00Z"
    }
  ],
  "NextToken": "",
  "PageNumber": 1,
  "PageSize": 20,
  "TotalCount": 1
}

UpdateAssetGroup

修改名称或描述。

curl -X POST 'https://ai.tuiwo.vip/ai?Action=UpdateAssetGroup&Version=2024-01-01' \
  -H 'Authorization: Bearer $TUIWO_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"Id":"GROUP_ID","Name":"新名称"}'

字段	类型	必填	说明
`Id`	string	是	素材组 ID
`Name`	string	否	新名称
`Description`	string	否	新描述
`ProjectName`	string	否	默认 `default`

响应 Result.Id。

DeleteAssetGroup

删除素材组及其下全部素材，操作不可恢复。

curl -X POST 'https://ai.tuiwo.vip/ai?Action=DeleteAssetGroup&Version=2024-01-01' \
  -H 'Authorization: Bearer $TUIWO_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"Id":"GROUP_ID"}'

删除真人认证的私有组时，可能需要组已过期或认证已被拒绝。删除后组内素材不能继续用于生成。

CreateAssetGroup

请求

响应

GetAssetGroup

ListAssetGroups

UpdateAssetGroup

DeleteAssetGroup

目录