删除素材组
DELETE /api/volc-user/asset-groups
删除指定素材组。删除素材组会同时删除该组下的所有素材。
删除成功表示平台本地删除已提交:素材组及组内所有未删除素材(包括已禁用、审核中或失败的素材)立即不可见,且不可用于提交新任务。上游资源和平台源文件由后台异步清理;清理进度、失败原因和重试仅在管理后台查看。
引用这些素材但尚未提交上游的视频任务会取消,并按现有规则退还预扣额度。已提交或提交结果尚未确认的任务继续收敛,相关资源等任务确认结束后再清理。
对同一用户已经删除的资源重复删除会返回成功,不重复创建清理任务。资源不存在或无权访问时仍返回失败。
鉴权说明
用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: <access_token>,令牌由 生成访问令牌 获取)。此令牌与模型调用使用的 sk- 密钥不同。
请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
id | string | 必选 | 素材组 ID |
请求示例
{
"body": {
"id": "group-7f2b8d9c"
}
}
响应字段(200)
| 字段名 | 类型 | 说明 |
|---|---|---|
success | boolean | 本地删除是否已提交;不表示后台物理清理已完成 |
message | string | 提示信息 |
data | object | 响应数据 |
data.id | string | 素材组 ID |
响应示例
{
"success": true,
"message": "",
"data": {
"id": "group-7f2b8d9c"
}
}