f2dc8d4713
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 11m59s
之前 DELETE /api/v1/assets/groups/<id> 的做法是循环调 DeleteAsset 再
删本地记录，现在火山开放了 DeleteAssetGroup（文档明确级联删除组内所有
Asset），改为一次调用，原子、快、无半成功。
变更
- backend/utils/assets_client.py:
- ApiInfo 注册 DeleteAssetGroup
- 新增 delete_asset_group(group_id)
- backend/apps/generation/views.py:
- asset_group_detail_view DELETE 分支改为一次 delete_asset_group
- 加幂等保护: 火山返回 NotFound.group_id 时继续清本地, 修复场景为
用户在火山控制台手删素材组后本地 DB 出现孤儿, 再在前端点一次
"删除素材组"即可清掉本地残留
测试 (airlabs-test)
- assets_client 4 项 PASS: 创建 → 删除 → 验证 gone → 重删返回
NotFound.group_id → 纯假 id 同样 NotFound.group_id
- view 层 2 场景 PASS:
- A 火山+本地都在 → 都清空
- B 火山侧已手删, 本地还在 → 本地也能清
文档整理
- docs/API文档/about-Asset-素材组相关/ 新增 8 个火山最新 Asset API 文档
(CreateAsset/Group, List*, Get*, Update*, Delete*), 原"使用指南"移入
该目录归档
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
82 lines
2.7 KiB
Plaintext
82 lines
2.7 KiB
Plaintext
`POST https://ark.cn-beijing.volcengineapi.com/?Action=DeleteAssetGroup&Version=2024-01-01`
|
||
删除素材资产组（Asset Group）。
|
||
:::warning
|
||
|
||
* 删除素材组将批量删除组内所有素材资产，该操作不可逆，一经删除，不可恢复，请谨慎操作。
|
||
* 如待删除的素材组包含较多素材资产，删除操作可能耗费一定时间。
|
||
* 对于在方舟控制台创建的真人素材组，**仅可删除授权已过期或已拒绝接收的素材组；** 授权有效期内、有效期未开始或已接收的素材无法删除。
|
||
|
||
|
||
:::
|
||
```mixin-react
|
||
return (<Tabs>
|
||
<Tabs.TabPane title="快速入口" key="lvNm2K2e"><RenderMd content={`<span> </span> [调用教程](https://www.volcengine.com/docs/82379/2333565) <span> </span> [接口列表](https://www.volcengine.com/docs/82379/2333601) <span> </span> [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
|
||
`}></RenderMd></Tabs.TabPane>
|
||
<Tabs.TabPane title="鉴权说明" key="jTfWOr00"><RenderMd content={`本接口仅支持 Access Key（AK/SK）鉴权。
|
||
`}></RenderMd></Tabs.TabPane></Tabs>);
|
||
```
|
||
|
||
|
||
---
|
||
|
||
|
||
<span id="jsH8fA91"></span>
|
||
## 请求参数
|
||
<span id="LZAiABbI"></span>
|
||
### 请求体
|
||
|
||
---
|
||
|
||
|
||
**Id** `string` %%require%%
|
||
需删除的素材资产组 ID。
|
||
|
||
---
|
||
|
||
|
||
**ProjectName** `string`
|
||
需删除素材资产组所属的项目名称，默认值为 default。
|
||
若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
|
||
<span id="pzKKGMI2"></span>
|
||
## 响应参数
|
||
:::tip
|
||
本接口无业务返回参数。
|
||
|
||
:::
|
||
---
|
||
|
||
|
||
<span id="W7hm7e18"></span>
|
||
## 请求示例
|
||
```text
|
||
POST /?Action=DeleteAssetGroup&Version=2024-01-01 HTTP/1.1
|
||
Host: ark.cn-beijing.volcengineapi.com
|
||
Content-Type: application/json
|
||
X-Date: 20260328T000000Z
|
||
X-Content-Sha256: 287e874e******d653b44d21e
|
||
Authorization: HMAC-SHA256 Credential=AKLTYz******/20260328/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=47a7d934******e41085f
|
||
|
||
{
|
||
"Id": "group-2026**********-*****",
|
||
"ProjectName": "default"
|
||
}
|
||
```
|
||
|
||
<span id="wUMBBtP9"></span>
|
||
## 响应示例
|
||
```json
|
||
{
|
||
"ResponseMetadata": {
|
||
"RequestId": "20260328000000000000000000000000",
|
||
"Action": "DeleteAssetGroup",
|
||
"Version": "2024-01-01",
|
||
"Service": "ark",
|
||
"Region": "cn-beijing"
|
||
},
|
||
"Result": {}
|
||
}
|
||
```
|
||
|
||
|
||
|