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>
94 lines
2.9 KiB
Plaintext
94 lines
2.9 KiB
Plaintext
`POST https://ark.cn-beijing.volcengineapi.com/?Action=UpdateAssetGroup&Version=2024-01-01`
|
||
更新单个 Asset Group（素材资产组合）信息。当前仅支持更新 Asset Group（素材资产组合）的 Name 和 Description。
|
||
|
||
```mixin-react
|
||
return (<Tabs>
|
||
<Tabs.TabPane title="快速入口" key="dZF0anlOBU"><RenderMd content={`<span> </span> [调用教程](https://www.volcengine.com/docs/82379/2333565) <span> </span> [接口列表](https://www.volcengine.com/docs/82379/2318269) <span> </span> [开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
|
||
`}></RenderMd></Tabs.TabPane>
|
||
<Tabs.TabPane title="鉴权说明" key="peae1e0Xvc"><RenderMd content={`本接口仅支持 Access Key（AK/SK）鉴权。
|
||
`}></RenderMd></Tabs.TabPane></Tabs>);
|
||
```
|
||
|
||
|
||
---
|
||
|
||
|
||
<span id="request-params"></span>
|
||
## 请求参数
|
||
<span id="request-body"></span>
|
||
### 请求体
|
||
|
||
---
|
||
|
||
|
||
**Id** `string` %%require%%
|
||
需要更新的 Asset Group（素材资产组合）的 Id。
|
||
|
||
---
|
||
|
||
|
||
**Name** `string`
|
||
需要更新的 Asset Group（素材资产组合）的新名称，上限为 64 个字符。
|
||
|
||
---
|
||
|
||
|
||
**Description** `string`
|
||
需要更新的 Asset Group（素材资产组合）的新描述，上限为 300 字符。
|
||
|
||
---
|
||
|
||
|
||
**ProjectName** `string`
|
||
需要更新的 Asset Group（素材资产组合）所属的项目名称，默认值为default。
|
||
若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
|
||
<span id="response-params"></span>
|
||
## 响应参数
|
||
|
||
---
|
||
|
||
|
||
**Id** `string`
|
||
Asset Group（素材资产组合）的 Id。
|
||
|
||
---
|
||
|
||
|
||
<span id=".6K-35rGC56S65L6L"></span>
|
||
## 请求示例
|
||
```text
|
||
POST /?Action=UpdateAssetGroup&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**********-*****",
|
||
"Name": "new-name",
|
||
"Description": "new-description",
|
||
"ProjectName": "default"
|
||
}
|
||
```
|
||
|
||
<span id=".5ZON5bqU56S65L6L"></span>
|
||
## 响应示例
|
||
```json
|
||
{
|
||
"ResponseMetadata": {
|
||
"RequestId": "20260328000000000000000000000000",
|
||
"Action": "UpdateAssetGroup",
|
||
"Version": "2024-01-01",
|
||
"Service": "ark",
|
||
"Region": "cn-beijing"
|
||
},
|
||
"Result": {
|
||
"Id": "group-2026**********-*****"
|
||
}
|
||
}
|
||
```
|
||
|
||
|
||
|