# 查询素材资产组合信息

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetAssetGroup&Version=2024-01-01`

获取单个 Asset Group（素材资产组合）信息。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

---

<span id="request-parameters"></span>
## 请求参数

### Body 参数

**Id** `string` `必选` | 素材组 ID

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

**ProjectName** `string` `默认值 default` | 所属项目

需要查询的 Asset Group（素材资产组合）所属的项目名称。若资源不在默认项目中，需填写正确的项目名称。

## 响应参数

**CreateTime** `string` | 创建时间

**Description** `string` | 素材组描述

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

**GroupType** `string` | 素材组类型

Asset Group（素材资产组合）的类型。取值：
* `AIGC`：虚拟人像；
* `LivenessFace`：真人素材

**Id** `string` | 素材组 ID

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

**Name** `string` | 素材组名称

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

**ProjectName** `string` | 所属项目

资源所属的项目名称

**UpdateTime** `string` | 更新时间


## 代码示例

## 默认

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetAssetGroup&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "Id": "group-20240514212750-b5e9m",
    "ProjectName": "default"
}
'
```

#### Response

```
{
    "ResponseMetadata": {
        "RequestId": "20240514213000F6789ABCDEF0123456",
        "Action": "GetAssetGroup",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "group-20240514212750-b5e9m",
        "Name": "demo-portrait-group",
        "Description": "虚拟人像素材组示例",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2024-05-14T21:27:50Z",
        "UpdateTime": "2024-05-14T21:30:00Z"
    }
}
```