跳转到主要内容
DELETE
/
kyyReactApiServer
/
kyyVideo2
/
asset
/
{assetId}
curl --request DELETE \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/asset-20260330142158-q75m8 \
  --header 'Authorization: Bearer {{key}}'
{
  "code": "0",
  "msg": "删除成功",
  "data": null
}

KyyVideo2 删除素材

删除指定素材。删除后不可恢复,请谨慎操作。
重要提示:
  • 素材删除后无法恢复
  • 删除前请确认该素材不再被使用
  • 建议在删除前先备份重要素材

认证

所有请求都需要在请求头中包含 Bearer token:
Authorization: Bearer {{key}}

路径参数

assetId
string
必填
要删除的素材 ID示例:asset-20260330142158-q75m8

响应参数

code
string
响应状态码
  • "0" - 删除成功
  • 其他值 - 删除失败
msg
string
响应消息
  • 成功时返回 "删除成功"
  • 失败时返回具体错误信息
data
null
数据字段,删除操作返回 null

使用场景

清理无用素材

删除不再需要的素材,释放存储空间

素材管理

管理素材库,保持素材列表整洁

错误素材清理

删除上传失败或错误的素材

隐私保护

删除包含敏感信息的素材

删除前检查

1

确认素材信息

使用素材详情接口确认要删除的素材信息
2

检查使用情况

确认该素材未被正在进行的视频生成任务使用
3

执行删除

调用删除接口,删除素材
4

验证结果

通过素材列表或详情接口验证素材已被删除
删除说明:
  • 删除操作是永久性的,无法撤销
  • 删除素材不会影响已生成的视频
  • 删除后,该素材 ID 将无法再使用
  • 建议定期清理不需要的素材
最佳实践:
  • 删除前先查询素材详情,确认是否为目标素材
  • 对于重要素材,建议先下载备份再删除
  • 批量删除时,建议逐个删除并检查结果
  • 记录已删除的素材 ID,避免误用
curl --request DELETE \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/asset-20260330142158-q75m8 \
  --header 'Authorization: Bearer {{key}}'
{
  "code": "0",
  "msg": "删除成功",
  "data": null
}