获取文件列表
更新时间：2025-11-21
GET
https://qianfan.baidubce.com/v2/files
获取已上传的文件列表。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
after
string
分页游标。after是一个对象ID，用于定义你在列表中的位置。
例如：如果你发起了一个列表请求并收到了100个对象，最后一个对象的ID是obj_foo，那么你可以在下一次请求中带上after=obj_foo来获取列表的下一页内容。
可选
limit
string
限制返回对象的数量。取值范围为1到10000，默认值为10000。
可选
order
string
基于created_at时间戳的排序方式。
asc表示升序（旧文件在前），desc表示降序（新文件在前）。
可选
purpose
string
仅返回指定 purpose（用途）的文件。
可选
请求结构
GET /v2/files?purpose=fine-tune&limit=10 HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
请求示例
curl "https://qianfan.baidubce.com/v2/files?purpose=fine-tune&limit=3&order=desc" \
-H "Authorization: Bearer bce-v3/ALTAK-*********/614fb**********"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
array
文件信息列表。
可选
显示子属性
隐藏子属性
items
object {6}
显示子属性
隐藏子属性
id
string
文件唯一标识符。
可选
object
string
固定值为：file。
可选
bytes
integer
文件大小，单位字节。
可选
created_at
integer
文件上传的时间戳。
可选
filename
string
文件名称。
可选
purpose
string
文件用途，对应请求中的purpose字段。
可选
JSON
{
"data": [
{
"id": "file-*****2ezxu",
"object": "file",
"bytes": 515,
"created_at": 1763691789,
"filename": "mydata.jsonl",
"purpose": "fine-tune"
},
{
"id": "file-*****dhpp9",
"object": "file",
"bytes": 515,
"created_at": 1763691455,
"filename": "mydata.jsonl",
"purpose": "fine-tune"
},
{
"id": "file-*****jcetb",
"object": "file",
"bytes": 515,
"created_at": 1763623133,
"filename": "mydata.jsonl",
"purpose": "fine-tune"
}
],
"object": "list"
}JSON
{
"error": {
"code": "invalid_delete_file",
"message": "file not found",
"type": "invalid_request_error"
},
"id": "as-*****9wek6"
}错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。