跳到正文

查詢複製音訊

按 `file_id` 查詢一個尚未使用的上傳檔案;免費。

GET/v1/files/retrieve

只能查到你本人上傳、仍然有效的檔案;已被複製用掉或超過 24 小時的檔案回傳 404。

請求標頭

Authorization:必填string

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

查詢參數

file_id:必填integer

上傳時回傳的檔案 ID

範圍≥ 1

回傳

200檔案資訊

file:選填object

上傳的檔案

base_resp:選填object

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

錯誤

400file_id must be a positive integer
401沒帶金鑰、金鑰無效或已過期(missing_api_key / invalid_api_key / api_key_expired)
404檔案不存在、已使用或已過期:file_id N does not exist
503file lookup is temporarily unavailable; please retry

相關頁面