檔案與批次
刪除檔案
刪除目前組織擁有的已上傳檔案。
概述
刪除透過 /v1/files 建立的檔案。批次檔案和 TokenLab 建立的圖像參考檔案會回傳 OpenAI 相容的 deleted 物件。
當請求選擇 Anthropic Files 相容模式時,同一路徑會從繫結工作區刪除 Anthropic 風格檔案。
注意事項
- 刪除檔案不會取消已經引用該檔案的批次工作。
- 不存在或無權存取的 file id 會回傳公開的 not-found 錯誤,不暴露路由狀態。
- 只有在沒有待處理的圖像編輯請求需要該參考檔案後,才刪除圖像參考檔案。
請求
curl -X DELETE "https://api.tokenlab.sh/v1/files/file_abc123" \
-H "Authorization: Bearer sk-your-api-key"請求 / 回應
使用上方互動式 OpenAPI 面板查看精確 schema。
{ "id": "string", "object": "file", "deleted": true}授權
BearerAuth AuthorizationBearer <token>
API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
路徑參數
file_id*string
Files API 返回的檔案 ID。
請求標頭
anthropic-beta?string
包含 files-api-2025-04-14 以使用 Anthropic Files API 模式。
回應
application/json
application/json
application/json