TokenLab

檔案與批次

刪除檔案

刪除目前組織擁有的已上傳檔案。

DELETE
/v1/files/{file_id}

概述

刪除透過 /v1/files 建立的檔案。批次檔案和 TokenLab 建立的圖像參考檔案會回傳 OpenAI 相容的 deleted 物件。

當請求選擇 Anthropic Files 相容模式時,同一路徑會從繫結工作區刪除 Anthropic 風格檔案。

注意事項

  • 刪除檔案不會取消已經引用該檔案的批次工作。
  • 不存在或無權存取的 file id 會回傳公開的 not-found 錯誤,不暴露路由狀態。
  • 只有在沒有待處理的圖像編輯請求需要該參考檔案後,才刪除圖像參考檔案。

範例

請求

cURL
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