文件列出

开发指南 API参考

模型价格模型发布

使用本接口，列出不同分类下的文件。

GET/v1/files/list

授权

Authorizationstringheader必填

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在项目管理>API Key 中查看。

查询参数

purpose string 必填

列出文件分类。取值及支持格式如下：

voice_clone: 快速克隆原始文件
prompt_audio: 声音克隆的示例音频
t2a_async_input: 异步长文本语音合成输入文件
t2a_async: 异步长文本语音合成生成音频文件
a2t_async_input: 异步语音转写输入音频文件
ocr_async_input: 文档解析输入文档文件
ocr_async_md: 文档解析输出md文件
ocr_async_json: 文档解析输出json文件

响应体结构

filesarray<object>

包含文件信息的列表，每个文件对象包括：

files[i].file_idinteger<int64>

文件的唯一标识符

files[i].bytesinteger<int64>

文件大小，以字节为单位

files[i].created_atinteger<int64>

创建文件时的 Unix 时间戳，以毫秒为单位

files[i].filenamestring

文件的名称

files[i].purposestring

文件的使用目的

base_respobject

base_resp.status_codeinteger

状态码如下：

100001, 请求参数错误
101999, 服务内部错误

更多内容可查看错误码了解详情

base_resp.status_msgstring

状态详情

List Files

curl --request GET \
  --url 'https://maas-api.hivoice.cn/v1/files/list?purpose=t2a_async' \
  --header 'Authorization: Bearer <api_key>'

200

{
  "files": [
    {
      "file_id": 123456789,
      "bytes": 213836,
      "created_at": 1774268796,
      "filename": "test.wav",
      "purpose": "voice_clone"
    },
    {
      "file_id": 987654321,
      "bytes": 259325,
      "created_at": 1774268796,
      "filename": "test.jpg",
      "purpose": "ocr_async_input"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}