列举文件-大模型服务平台百炼(Model Studio)-阿里云帮助中心

列举当前账号下所有已上传的文件信息，支持分页查询。

列举当前所有的文件

GET https://dashscope.aliyuncs.com/api/v1/files
Accept: application/json

请求示例

curl --location --request GET "https://dashscope.aliyuncs.com/api/v1/files?page_no=1&page_size=20" \
--header "Authorization: Bearer ${DASHSCOPE_API_KEY}"

请求参数

字段	类型	传参方式	必选	描述
page_no	Number	Query	是	当前页，最小值为1，默认值为1
page_size	Number	Query	是	分页大小。最小值为1，最大值为100，默认值为10

返回示例

{
    "request_id": "123456",
    "data": {
        "total": 2,
        "page_size": 20,
        "page_no": 1,
        "files": [
            {
                "id": 1001,
                "file_id": "9G2EaQtq7p1fw7oRhYXdHTtDFYAMVQSh95432B38CAB211EDB8F952C2E8001733",
                "name": "test.txt",
                "description": "1",
                "size": 0,
                "md5": "d41d8cd98f00b204e9800998ecf8427e",
                "gmt_create": "2023-03-25 10:13:07",
                "url": "http://xxx.oss-cn-hangzhou.aliyuncs.com/oss%3A//dashscope-dev/api-fs/123456/123456/test.txt",
                "region": "cn-hangzhou",
                "user_id": "123456",
                "api_key_id": "sk-xxxx",
                "purpose": "fine-tune"
            },
            {
                "id": 1002,
                "file_id": "wmIDj6zemqjIb8L2o8NHIlMRk3QinjGP00E987C7CA3711ED83E0000EC63B0D1C",
                "name": "sdsdsd.mp4",
                "description": "1",
                "size": 780635,
                "md5": "8382b3d3137bce6eaf1beef9c8920ef6",
                "gmt_create": "2023-03-24 19:28:30",
                "url": "http://xxxx.oss-cn-hangzhou.aliyuncs.com/oss%3A//dashscope-dev/api-fs/123456/123456/sdsdsd.mp4",
                "region": "cn-hangzhou",
                "user_id": "123456",
                "api_key_id": "sk-xxxx",
                "purpose": "file-extract"
            }
        ]
    }
}

返回参数

字段	类型	描述
data.total	Number	总记录数
data.page_size	Number	分页大小
data.page_no	Number	当前页
data.files	Array	文件列表
data.files.$.file_id	String	文件ID，可用于查询文件详情和删除文件接口
data.files.$.url	String	文件下载链接
data.files.$.name	String	文件名
data.files.$.size	Number	文件大小
data.files.$.md5	String	文件的md5
data.files.$.description	String	文件的描述
data.files.$.gmt_create	Date	文件上传时间
data.files.$.id	Number	文件的内部ID
data.files.$.region	String	文件所在地域
data.files.$.user_id	String	用户ID
data.files.$.api_key_id	String	API Key ID
data.files.$.purpose	String	文件用途
request_id	String	本次请求的系统唯一码