API 文档AI 模型接口视频Seedance素材
更新素材组
更新素材组名称和简介。未传入的字段保持不变。
更新素材组的名称和简介,只能修改当前用户有权限的素材组。groupName 最长 64 个字符,description 最长 300 个字符。不传的字段不会被修改。
Base URL
https://api.autorouter.top— Production
Authentication
BearerAuth: http (bearer)
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
Endpoints
PUT /seedance/v1/asset-group/{groupId}
更新素材组
更新名称或简介,并返回更新后的素材组。
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
groupId | string | Yes | 素材组 ID(火山资产组 ID) |
Request Body
Content-Type: application/json
Example:
{
"groupName": "我的AIGC素材组",
"description": "用于数字人视频生成的素材集合"
}Properties:
| Name | Type | Required | Description |
|---|---|---|---|
groupName | string | No | 素材组名称,最长 64 个字符。不传则不更新 |
description | string | No | 素材组简介,最长 300 个字符。不传则不更新 |
groupNamestring(可选)
素材组名称,最长 64 个字符。不传则不更新
descriptionstring(可选)
素材组简介,最长 300 个字符。不传则不更新
Responses
200: 成功
Content-Type: application/json
请求示例
curl -X PUT "https://api.autorouter.top/seedance/v1/asset-group/{groupId}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxx" \
-d '{
"groupName": "我的AIGC素材组",
"description": "用于数字人视频生成的素材集合"
}'响应示例
{
"requestId": "75ea7c21-6c8a-4a03-bcc5-bc2037913235",
"state": "OK",
"errorCode": null,
"errorMessage": null,
"body": {
"groupId": "group-20260803100400-drhhj",
"groupType": "AIGC",
"groupName": "我的AIGC素材组",
"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. | string | 火山资产组 ID |
body. | string | 素材组类型,取值为 AIGC 或 LivenessFace |
body. | string | 素材组名称 |
body. | string | 素材组简介 |
body. | string | 创建时间,格式 yyyy-MM-dd HH:mm:ss |
body. | 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。