刪除複製音訊

刪除一個尚未使用的上傳檔案；免費，不影響已複製的音色。

POST/v1/files/delete

file_id 與 purpose 須與上傳時一致。刪除檔案不影響已複製的音色；複製成功後原始檔案本就會自動刪除，這裡只用於清理沒用上的檔案。

刪除複製音訊

curl https://api.hop-base.com/v1/files/delete \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": 123456789,
    "purpose": "voice_clone"
  }'

200application/json

{
  "file_id": 123456789,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

請求標頭

Authorization:必填string

Bearer sk-…：主控台「API 金鑰」中建立的金鑰，所屬分組須包含請求的模型

請求主體參數JSON

file_id:必填integer

上傳時回傳的檔案 ID

範圍≥ 1

purpose:必填string

上傳時的用途

可選值voice_cloneprompt_audio

回傳

200已刪除

file_id:選填integer

已刪除的檔案 ID

base_resp:選填object

成功時為 {"status_code": 0, "status_msg": "success"}；錯誤不走這裡，而是非 200 狀態碼加 error 物件

錯誤

400file_id 不是正整數、purpose 取值錯誤或出現未知欄位

401沒帶金鑰、金鑰無效或已過期（missing_api_key / invalid_api_key / api_key_expired）

404檔案不存在、已使用、已過期或 purpose 不符：file_id N does not exist

413請求體超過 64 KiB：request body is too large

503file deletion is temporarily unavailable; please retry 等

請求標頭

請求主體參數JSON

回傳

錯誤

相關頁面