GlobalAiOpc

删除素材

删除指定素材,删除后不可恢复,请谨慎操作

DELETE/kyyReactApiServer/kyyVideo2/asset/{assetId}

Seedance2.0 删除素材

删除指定素材。删除后不可恢复,请谨慎操作。
重要提示:
  • 素材删除后无法恢复
  • 删除前请确认该素材不再被使用
  • 建议在删除前先备份重要素材
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

路径参数

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

响应参数

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

使用场景

清理无用素材

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

素材管理

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

错误素材清理

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

隐私保护

删除包含敏感信息的素材

删除前检查

确认素材信息

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

检查使用情况

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

执行删除

调用删除接口,删除素材

验证结果

通过素材列表或详情接口验证素材已被删除
删除说明:
  • 删除操作是永久性的,无法撤销
  • 删除素材不会影响已生成的视频
  • 删除后,该素材 ID 将无法再使用
  • 建议定期清理不需要的素材
最佳实践:
  • 删除前先查询素材详情,确认是否为目标素材
  • 对于重要素材,建议先下载备份再删除
  • 批量删除时,建议逐个删除并检查结果
  • 记录已删除的素材 ID,避免误用