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