POST https://art-api.yuyuflow.com/?Action=CreateAssetGroup&Version=2024-01-01

创建 Asset Group（素材资产组合）组合，用作素材资产管理。

说明

首次创建 Asset Group 前，需先在控制台签署授权函。详情请参考使用指南。

鉴权说明

本接口仅支持 Access Key（AK/SK）鉴权。

请求参数​

请求体​

Name string 必选

Asset Group（素材资产组合）的名称，上限为 64 字符。

Description string

Asset Group（素材资产组合）的描述，上限为 300 字符。

GroupType string

Asset Group（素材资产组合）的类型。可选值：

  • AIGC：虚拟人像（当前仅支持该类型）。

ProjectName string

资源所属的项目名称，默认值为 default。

若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 文档。

响应参数​

Id string

Asset Group（素材资产组合）的 Id。

请求示例​

text
POST /?Action=CreateAssetGroup&Version=2024-01-01 HTTP/1.1
Host: art-api.yuyuflow.com
Content-Type: application/json
X-Date: 20260328T000000Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=AKLTYz******/20260328/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=47a7d934******e41085f

{
  "Name": "test",
  "Description": "test",
  "GroupType": "AIGC",
  "ProjectName": "default"
}

响应示例​

json
{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-2026**********-*****"
  }
}