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>
169 lines
3.6 KiB
Plaintext
169 lines
3.6 KiB
Plaintext
`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetAsset&Version=2024-01-01`
|
||
查询素材资产状态，确认素材是否已完成预处理并可用于推理。
|
||
|
||
```mixin-react
|
||
return (<Tabs>
|
||
<Tabs.TabPane title="快速入口" key="k6xoCAAzLe"><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="NcZDHXiFXA"><RenderMd content={`本接口仅支持 Access Key（AK/SK）鉴权。
|
||
`}></RenderMd></Tabs.TabPane></Tabs>);
|
||
```
|
||
|
||
|
||
---
|
||
|
||
|
||
<span id="request-params"></span>
|
||
## 请求参数
|
||
<span id="request-body"></span>
|
||
### 请求体
|
||
|
||
---
|
||
|
||
|
||
**Id** `string` %%require%%
|
||
Asset（素材资产）的 Id。
|
||
|
||
---
|
||
|
||
|
||
**ProjectName** `string`
|
||
需要查询的 Asset（素材资产）所属的项目名称，默认值为 `default`。
|
||
若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
|
||
<span id="response-params"></span>
|
||
## 响应参数
|
||
|
||
---
|
||
|
||
|
||
**Id** `string`
|
||
Asset（素材资产）的 Id。
|
||
|
||
---
|
||
|
||
|
||
**Name** `string`
|
||
Asset（素材资产）的名称，上限为 64 个字符。
|
||
|
||
---
|
||
|
||
|
||
**URL** `string`
|
||
Asset（素材资产）的访问地址。有效期为 12 小时，请及时保存。
|
||
|
||
---
|
||
|
||
|
||
**AssetType** `string`
|
||
Asset（素材资产）的类型。可选值：
|
||
|
||
* `Image`
|
||
* `Video`
|
||
* `Audio`
|
||
|
||
|
||
---
|
||
|
||
|
||
**GroupId** `string`
|
||
Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id。
|
||
|
||
---
|
||
|
||
|
||
**Status** `string`
|
||
素材资产状态。可选值：
|
||
|
||
* `Active`：已处理完毕，可以使用
|
||
* `Processing`：正在预处理，无法使用
|
||
* `Failed`：处理失败
|
||
|
||
|
||
---
|
||
|
||
|
||
**Error** `object`
|
||
错误信息。
|
||
属性
|
||
|
||
---
|
||
|
||
|
||
Error.**Code** `string`
|
||
错误码。
|
||
|
||
---
|
||
|
||
|
||
Error.**Message** `string`
|
||
错误信息。
|
||
|
||
---
|
||
|
||
|
||
**CreateTime** `string`
|
||
创建时间。
|
||
|
||
---
|
||
|
||
|
||
**UpdateTime** `string`
|
||
更新时间。
|
||
|
||
---
|
||
|
||
|
||
**ProjectName** `string`
|
||
资源所属的项目名称。
|
||
|
||
---
|
||
|
||
|
||
<span id=".6K-35rGC56S65L6L"></span>
|
||
## 请求示例
|
||
```text
|
||
POST /?Action=GetAsset&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": "Asset-2026**********-*****",
|
||
"ProjectName": "default"
|
||
}
|
||
```
|
||
|
||
<span id=".5ZON5bqU56S65L6L"></span>
|
||
## 响应示例
|
||
```json
|
||
{
|
||
"ResponseMetadata": {
|
||
"RequestId": "20260328000000000000000000000000",
|
||
"Action": "GetAsset",
|
||
"Version": "2024-01-01",
|
||
"Service": "ark",
|
||
"Region": "cn-beijing"
|
||
},
|
||
"Result": {
|
||
"Id": "Asset-2026**********-*****",
|
||
"Name": "test",
|
||
"URL": "https://example.com/asset-url",
|
||
"AssetType": "Image",
|
||
"GroupId": "group-2026**********-*****",
|
||
"Status": "Active",
|
||
"Error": {
|
||
"Code": "",
|
||
"Message": ""
|
||
},
|
||
"CreateTime": "2026-03-28T00:00:00Z",
|
||
"UpdateTime": "2026-03-28T00:00:00Z",
|
||
"ProjectName": "default"
|
||
}
|
||
}
|
||
```
|
||
|
||
|
||
|