# 创建素材组

URL: http://localhost:3000/docs/zh-cn/api/asset-library/CreateAssetGroup

创建一个 AIGC（虚拟）素材组。只能创建 AIGC 类型；真人素材组（LivenessFace）走真人认证流程创建。



创建一个 AIGC（虚拟）素材组，用于归置素材。只支持 `GroupType=AIGC`；真人素材组通过 [CreateVisualValidateSession](/zh-cn/api/asset-library/CreateVisualValidateSession) 创建。接入信息与鉴权见[素材库总览](/zh-cn/api/asset-library)。

<ArkOperation>
  <div>
    ## 请求参数 [#请求参数]

    | 参数            | 类型     | 必填 | 说明                  |
    | ------------- | ------ | -- | ------------------- |
    | `Name`        | string | 是  | 素材组名称，最多 64 个字符     |
    | `Description` | string | 否  | 素材组描述，最多 300 个字符    |
    | `GroupType`   | string | 是  | 素材组类型，必须为 `AIGC`    |
    | `ProjectName` | string | 否  | 资源所属项目，默认 `default` |

    ## 响应参数 [#响应参数]

    `Result` 结构：

    | 字段   | 类型     | 说明                    |
    | ---- | ------ | --------------------- |
    | `Id` | string | 新建素材组的 Id（形如 `grp_…`） |

    ## 错误码 [#错误码]

    | Code                             | 说明                       |
    | -------------------------------- | ------------------------ |
    | `MissingParameter.Name`          | 未传 `Name`                |
    | `InvalidParameter.Name`          | `Name` 超过 64 个字符         |
    | `InvalidParameter.Description`   | `Description` 超过 300 个字符 |
    | `InvalidParameter.GroupType`     | `GroupType` 不是 `AIGC`    |
    | `AccessDenied`                   | 无该项目成员权限                 |
    | `OperationDenied.ServiceNotOpen` | 租户未开通素材库能力               |

    其余通用错误码见[素材库总览](/zh-cn/api/asset-library#错误码)。
  </div>

  <div>
    ## 在线调试 [#在线调试]

    <ArkTryIt method="POST" action="CreateAssetGroup" body="{ Name: '数字人形象库', Description: '示例素材组', GroupType: 'AIGC', ProjectName: 'default' }" />

    ## 请求示例 [#请求示例]

    ```json
    {
      "Name": "数字人形象库",
      "Description": "示例素材组",
      "GroupType": "AIGC",
      "ProjectName": "default"
    }
    ```

    ## 响应示例 [#响应示例]

    ```json
    {
      "ResponseMetadata": {
        "RequestId": "202603280000000000000000000000",
        "Action": "CreateAssetGroup",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
      },
      "Result": {
        "Id": "grp_0a1b2c3d4e5f"
      }
    }
    ```
  </div>
</ArkOperation>

## 官方文档 [#官方文档]

[创建素材资产组合（CreateAssetGroup）](https://docs.volcengine.com/docs/82379/2318270?lang=zh)