Esta página ainda está disponível apenas em chinês. A navegação e os menus já aparecem em português.

删除文件

DELETE https://api.inoneapi.com/v1/files/{file_id}

删除当前 Key 所属文件的 COS 对象和数据库元数据。成功后不能再用这个 ID 发起新的文件引用；删除不会撤回已经发送给上游的内容，也不会取消正在运行的生成任务。

所有请求都使用 Authorization: Bearer $INONEAPI_API_KEY，无需请求体。文件严格按上传 Key 隔离，即使属于同一用户或项目也不能跨 Key 操作。文件操作不产生模型推理费用，不要求正余额，但仍受 Key 限流、并发限制与项目状态约束。

请求参数

参数	位置	类型	说明
`file_id`	path	string	必填，上传返回的完整 ID：`file_ioa_` 加 32 位小写十六进制字符。不是 Playground 附件 ID 或服务商 ID。

以下 JavaScript 示例用于 Node.js 20+ 服务端；请先设置 INONEAPI_API_KEY。

curl  -X DELETE https://api.inoneapi.com/v1/files/file_ioa_0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer $INONEAPI_API_KEY"

{
  "id": "file_ioa_0123456789abcdef0123456789abcdef",
  "object": "file",
  "deleted": true
}

成功返回 HTTP 200，JSON 中 id 为删除的文件 ID，object 固定为 file，deleted 为 true。响应不是 HTTP 204。重复删除通常返回 404，不能假定每次都返回同一成功对象。

HTTP / code	原因与处理
404 `FILE_NOT_FOUND`	ID 无效、不存在或不属于此 Key。清理重试时可视为目标已不可访问，但不能据此判断他人文件存在。
409 `FILE_NOT_READY`	`uploading` 记录创建不足 5 分钟，避免与仍在执行的上传竞争；稍后重试。
503 `FILE_STORAGE_UNAVAILABLE`	COS 删除或数据库删除失败。保留 ID，查询状态后有限重试。

ready 文件可立即删除。中断遗留的 uploading 记录创建满 5 分钟后可删除。先删对象再删元数据，两步不保证原子性；503 或网络超时后对象可能已删除而记录仍存在。

COS 自动清理后的旧元数据也可以用此接口删除。删除 Key 后文件 ID 失效，剩余对象交由生命周期回收。异步模型仍可能需要读取素材，因此应在确认任务不再需要素材后清理。