查询素材组

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

按 Id 查询单个素材组。素材组按项目隔离，Id 属于其他项目时返回 NotFound。接入信息与鉴权见素材库总览。

请求参数

参数	类型	必填	说明
`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`	无该项目成员权限

其余通用错误码见素材库总览。

在线调试

「发送」会用你填写的 AK/SK 向所选服务器发起真实调用，与生产请求等效、可能产生计费。

POSThttps://maas-ark.stringx.top/?Action=GetAssetGroup&Version=2024-01-01

凭证Access Key IDSecret Access Key

RegionService

请求体（JSON）

请求示例

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

响应示例

{
  "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"
  }
}

官方文档

查询素材资产组合信息（GetAssetGroup）