APIByteDanceSeedance series
Asset groups
Create, get, list, update and delete asset groups.
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": "Product images",
"Description": "Reference assets",
"GroupType": "AIGC",
"ProjectName": "default"
}'| Field | Type | Required | Description |
|---|---|---|---|
Name | string | yes | Group name, up to 64 characters |
Description | string | no | Description, up to 300 characters |
GroupType | string | no | For example AIGC or LivenessFace |
ProjectName | string | no | Project name, defaults to default |
Response:
{
"Result": {
"Id": "GROUP_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"}'| Field | Type | Required | Description |
|---|---|---|---|
Id | string | yes | Group ID |
ProjectName | string | no | Defaults to default |
Result fields: Id, Name, Description, GroupType, ProjectName, CreateTime, UpdateTime.
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":"Product"},"PageNumber":1,"PageSize":20}'| Field | Type | Description |
|---|---|---|
Filter.GroupType | string | Filter by group type |
Filter.GroupIds | string[] | Filter by group IDs |
Filter.Name | string | Filter by name |
NextToken | string | Cursor token |
MaxResults | integer | Cursor page size, 1-100 |
SortBy | string | CreateTime or UpdateTime |
SortOrder | string | Desc or Asc |
PageNumber | integer | Page number |
PageSize | integer | Page size; platform currently caps around 50 |
Response Result contains Items with the same group fields, plus NextToken, PageNumber, PageSize, and TotalCount.
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":"New name"}'| Field | Type | Required | Description |
|---|---|---|---|
Id | string | yes | Group ID |
Name | string | no | New name |
Description | string | no | New description |
ProjectName | string | no | Defaults to default |
Response 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"}'Deleting a group removes all its assets and is irreversible. Private liveness groups may need to be expired or rejected before deletion.