删除素材分组

国内端点

https://api.qnaigc.com

DELETE

/v1/asset-groups/{qgroupid}

删除指定 qgroupid 的素材分组（异步）

前置约束：

分组必须为空：组内仍有未软删素材时返回 409，需先逐个删除素材；

分组不能处于 pending 状态：返回 409，需等待处理完成；

仅 active/failed 终态分组可删。

幂等：重复删除已删除/不存在的分组返回 404。

权限：只能删除当前用户自己的分组（qgroupid 须形如 qgroup-{uid}-*，否则 403）。

默认分组：允许删除默认分组，删除后下次创建素材时会自动重建。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

🟢200

application/json

删除已受理

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.qnaigc.com/v1/asset-groups/' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "message": "deleted"
}

修改于 2026-06-08 07:58:51