跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

删除产物

POST /v1/storages/delete

永久删除一个或多个产物。删除持久产物会停止其存储计费。删除在列表与计费中立即生效；底层文件在后台清理。单批最多 50 个，采用部分成功语义。

请求头

Section titled “请求头”
Authorization Bearer YOUR_API_KEY 必填

账号 API Key，所有请求必填。

Content-Type application/json 必填

请求体为 JSON。

请求体

Section titled “请求体”

一个产物 id 的 JSON 数组——取自获取历史产物列表，以字符串形式传入。单批最多 50 个。

Terminal window
curl -X POST "https://api.hiapi.ai/v1/storages/delete" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '["90216", "90215"]'

响应

Section titled “响应”
{
  "code": 200,
  "message": "success",
  "data": {
    "accepted": ["90216"],
    "rejected": [
      { "id": "90215", "reason": "pending_archiving" }
    ]
  }
}
  • accepted —— 已删除的 id。它们立即从获取历史产物列表中移除，并停止计入存储费用。
  • rejected —— 未能删除的 id，每项附带原因。

拒绝原因

Section titled “拒绝原因”
reason含义
not_owned该账号下不存在此产物。
already_deleted产物已被删除。
pending_archiving产物仍在写入存储——请等其完成后重试。
storage_op_pending该产物已有进行中的存储操作——请稍后重试。