Seedance查询素材组详情API-素材库-AutoRouter

按素材组 ID 查询单个素材组。只返回当前用户有权限访问的素材组。响应不包含内部主键。

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Endpoints

GET `/seedance/v1/asset-group/{groupId}`

查询素材组详情

返回指定素材组的名称、类型、简介和创建时间。

Path Parameters

Name	Type	Required	Description
`groupId`	string	Yes	素材组 ID（火山资产组 ID）

Responses

200: 成功

Content-Type: application/json

请求示例

curl -X GET "https://api.autorouter.top/seedance/v1/asset-group/{groupId}" \
  -H "Authorization: Bearer sk-xxxxxx"

响应示例

{
  "requestId": "a9c502bc-3025-486a-b89e-d143c9001016",
  "state": "OK",
  "errorCode": null,
  "errorMessage": null,
  "body": {
    "groupId": "group-20260728104222-7xprw",
    "groupType": "AIGC",
    "groupName": "test",
    "description": "",
    "createdTime": "2026-07-01 17:07:18",
    "updatedTime": "2026-07-01 17:07:22"
  }
}

响应字段说明：

Name	Type	Description
`requestId`	string	请求 ID
`state`	string	调用状态。`OK` 表示成功，`ERROR` 表示失败
`errorCode`	string	异常码。成功时为空字符串或 `null`
`errorMessage`	string	异常消息。成功时为空字符串或 `null`
`body`	object	素材组信息
`body.groupId`	string	火山资产组 ID
`body.groupType`	string	素材组类型，取值为 `AIGC` 或 `LivenessFace`
`body.groupName`	string	素材组名称
`body.description`	string	素材组简介
`body.createdTime`	string	创建时间，格式 `yyyy-MM-dd HH:mm:ss`
`body.updatedTime`	string	更新时间，格式 `yyyy-MM-dd HH:mm:ss`

statestring

调用状态。OK 表示成功，ERROR 表示失败

OK：返回正常
ERROR：返回错误，请查看 errorCode 和 errorMessage

bodyobject

素材组信息

groupIdstring

火山资产组 ID

groupTypestring

素材组类型，取值为 AIGC 或 LivenessFace

AIGC：虚拟人像素材库
LivenessFace：真人素材库

groupNamestring

素材组名称

descriptionstring

素材组简介

createdTimestring

创建时间，格式 yyyy-MM-dd HH:mm:ss

updatedTimestring

更新时间，格式 yyyy-MM-dd HH:mm:ss

错误处理

HTTP 状态码为 200 时，仍需检查响应体中的 state。

`state`	说明
`OK`	调用成功，业务数据在 `body`
`ERROR`	调用失败。`errorCode` 为异常码，`errorMessage` 为异常消息

成功时 errorCode 和 errorMessage 可能为空字符串或 null。

查询素材组详情

statestring

bodyobject

属性

目录