# 查询素材组

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

按 Id 查询单个素材组。素材组按项目隔离，另一个项目下的组返回 NotFound。



按 Id 查询单个素材组。素材组按项目隔离，Id 属于其他项目时返回 `NotFound`。接入信息与鉴权见[素材库总览](/zh-cn/api/asset-library)。

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

    | 参数            | 类型     | 必填 | 说明                  |
    | ------------- | ------ | -- | ------------------- |
    | `Id`          | string | 是  | 素材组 Id              |
    | `ProjectName` | string | 否  | 资源所属项目，默认 `default` |

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

    `Result` 结构：

    | 字段            | 类型     | 说明                      |
    | ------------- | ------ | ----------------------- |
    | `Id`          | string | 素材组 Id                  |
    | `Name`        | string | 名称                      |
    | `Description` | string | 描述                      |
    | `GroupType`   | string | `AIGC` / `LivenessFace` |
    | `ProjectName` | string | 所属项目                    |
    | `CreateTime`  | string | 创建时间，ISO8601 UTC        |
    | `UpdateTime`  | string | 更新时间，ISO8601 UTC        |

    ## 错误码 [#错误码]

    | Code                  | 说明          |
    | --------------------- | ----------- |
    | `MissingParameter.Id` | 未传 `Id`     |
    | `NotFound`            | 素材组不存在或无权访问 |
    | `AccessDenied`        | 无该项目成员权限    |

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

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

    <ArkTryIt method="POST" action="GetAssetGroup" body="{ Id: 'grp_0a1b2c3d4e5f', ProjectName: 'default' }" />

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

    ```json
    {
      "Id": "grp_0a1b2c3d4e5f",
      "ProjectName": "default"
    }
    ```

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

    ```json
    {
      "ResponseMetadata": {
        "RequestId": "202603280000000000000000000000",
        "Action": "GetAssetGroup",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
      },
      "Result": {
        "Id": "grp_0a1b2c3d4e5f",
        "Name": "数字人形象库",
        "Description": "示例素材组",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-03-28T00:00:00Z",
        "UpdateTime": "2026-03-28T00:00:00Z"
      }
    }
    ```
  </div>
</ArkOperation>

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

[查询素材资产组合信息（GetAssetGroup）](https://docs.volcengine.com/docs/82379/2318275?lang=zh)