列出克隆音频
列出你尚未使用、仍然有效的上传文件;免费。
GET
/v1/files/list只返回你本人上传、尚未被克隆用掉且未过期(上传后 24 小时内)的文件,按 purpose 过滤。已上传的音频不支持下载。
请求头
Authorization:必填string
Bearer sk-…:控制台「API 密钥」里创建的密钥,所属分组须包含请求的模型
查询参数
purpose:必填string
要列出的文件用途
可选值voice_cloneprompt_audio
返回
200文件列表
files:可选array of object
文件
file_id:可选integer
文件 ID,克隆时传给 file_id 或 clone_prompt.prompt_audio
bytes:可选integer
文件字节数
created_at:可选integer
上传时间,Unix 秒
filename:可选string
文件名
purpose:可选string
voice_clone 或 prompt_audio
可选值voice_cloneprompt_audio
base_resp:可选object
成功时为 {"status_code": 0, "status_msg": "success"};错误不走这里,而是非 200 状态码加 error 对象
status_code:可选integer
成功为 0
status_msg:可选string
成功为 success
错误
400
purpose must be "voice_clone" or "prompt_audio"401没带密钥、密钥无效或已过期(
missing_api_key / invalid_api_key / api_key_expired)503
file lookup is temporarily unavailable; please retry