查询文件列表

分页查询当前租户上传的文件。该接口对齐 Files 的列表操作，返回 list 对象。

GET

/v1/files

分页返回当前租户上传的文件，支持按数量、偏移量与用途过滤。

认证

在请求头中加入 Authorization: Bearer <API_KEY> 完成鉴权，密钥可在控制台「API 密钥」页生成。

curl https://api.mosi.cn/v1/files \
  -H "Authorization: Bearer $MOSS_API_KEY"

请求参数

Query	类型	必填	说明
limit	integer	否	返回数量，有效范围 1–200。
offset	integer	否	偏移量，有效范围 0–100000。
purpose	string	否	按用途过滤。

请求示例

curl "https://api.mosi.cn/v1/files?purpose=audio&limit=20" \
  -H "Authorization: Bearer $MOSS_API_KEY"

响应字段

字段	类型	必返	说明
object	string	是	固定为 `list`。
data[].id	string	是	文件 id，即后续接口使用的 `file_id`。
data[].object	string	是	固定为 `file`。
data[].bytes	integer	是	文件字节数。
data[].created_at	integer	是	创建时间，Unix 时间戳，单位为秒。
data[].filename	string	是	原始文件名。
data[].purpose	string	是	文件用途标记；可能为空字符串。
data[].status	string	是	文件状态，以服务端实际返回为准。

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "<file_id>",
      "object": "file",
      "bytes": 1048576,
      "created_at": 1710000000,
      "filename": "speech.wav",
      "purpose": "audio",
      "status": "active"
    }
  ]
}

下一步

查询文件详情

查询单个文件的元信息。

删除文件

删除已上传文件。