获取文件列表
更新时间：2026-04-14
POST
https://qianfan.baidubce.com/v2/app/files/get
本接口根据文件ID获取文件详细信息列表。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
file_ids
array
文件ID列表，用于批量查询文件详细信息。
必选
显示子属性
隐藏子属性
items
string
purpose
string
文件用途
assistants：用于助手API，支持以下格式：- 图像：.jpg、.jpeg、.png、.gif
- 文档：.pdf、.doc、.docx、.pptx、.xlsx、.txt、.md、.tex
- 代码：.py、.java、.go、.c、.cpp、.cs、.js、.ts、.php、.rb、.html、.css、.sh
- 其他：.json、.xml、.csv、.zip、.tar、.pkl
batch：用于批处理API，支持.jsonl格式。fine-tune：用于模型微调，支持.jsonl格式。vision：用于视觉微调的图像，支持.png，.jpg，.jpeg，.webp格式。user_data：灵活文件类型，用于任何用途，格式无限制。evals：用于评估数据集，支持.jsonl格式。
可选
conversation_id
string
对话ID，关联文件所属对话。
可选
directory
string
文件所属目录。
可选
path
string
文件路径。
可选
limit
number
分页查询参数，限制单次查询返回的文件数量。默认值100。
可选
order
string
排序方式。asc：升序排列desc：降序排列
可选
after
string
分页游标，需传入上一页返回列表中最后一个file_id，用于拉取下一页数据。
可选
请求结构
POST /v2/app/files/get HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{"file_ids":["file-****z095"]}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/app/files/get" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"file_ids": [
"file-****z095"
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
响应状态码。
可选
message
string
响应消息。
可选
request_id
string
请求ID，用于追踪和调试。
可选
result
object {2}
返回数据，包含具体的文件列表信息。
可选
显示子属性
隐藏子属性
object
string
返回对象类型，固定值list。
可选
data
array
文件信息列表，包含查询到的文件详细信息。
可选
显示子属性
隐藏子属性
items
object {16}
显示子属性
隐藏子属性
file_id
string
文件ID。
可选
filename
string
文件名。
可选
path
string
文件路径。
可选
directory
string
文件所属目录。
可选
size
integer
文件大小，单位：字节 (Bytes)。
可选
purpose
string
文件用途。
可选
storage_location
string
BOS地址链接。
可选
conversation_id
string
对话ID，关联文件所属对话。
可选
message_id
string
消息ID。
可选
mime_type
string
文件类型。
可选
presigned_url
string
临时访问链接。
可选
viewer_url
string
在线预览文件的URL地址。
可选
metadata
object {5}
文件元数据。
可选
显示子属性
隐藏子属性
xmind_bos_url
string
BOS地址。
可选
xmind_bucket_name
string
BOS桶名。
可选
xmind_object_name
string
BOS对象名。
可选
xmind_short_summarize
string
简介。
可选
xmind_status
string
文件处理状态标识。
可选
created_at
string
创建时间，格式为ISO8601，时区为UTC。
可选
expires_at
string
过期时间，格式为ISO8601，时区为UTC。
可选
updated_at
string
更新时间，格式为ISO8601，时区为UTC。
可选
json
{
"code": "success",
"message": "",
"request_id": "d7ea8e76-****-43de-b94e-fdcfbd103128",
"result": {
"object": "list",
"data": [
{
"file_id": "file-****z095",
"filename": "1.jsonl",
"path": "/1.jsonl",
"directory": "/./",
"size": 16,
"purpose": "",
"storage_location": "bos://agi-dev-platform-file/files_test/4121****38434a1580eeb0b675450b91/uploads/file-****z095_1.jsonl",
"conversation_id": "eac4a699-****-497c-a6b5-dbc9e228b5a0",
"message_id": "",
"mime_type": "application/x-ndjson",
"presigned_url": "https://agi-dev-platform-file.bj.bcebos.com/files_test/4121fcd138434a1580eeb0b675450b91/uploads/file-****z095_1.jsonl?authorization=bce-auth-v1%2FALTAKGa8m4q*****oljdEDAzLm%2F2026-01-19T09%******2F259200%2Fhost%2F8d2eb8f975d73b220c749a09c64d79a8b5ef162f95ea13a8cf1aaaef681987aa",
"viewer_url": "http://localhost:8080/api/v1/viewer/file-vny9z095?ts=1768816237&sig=*****e967b16ae0b69e3ad8c4b6a91a3b8e3a0c2aa5bb2b56c248d121",
"metadata": null,
"created_at": "2026-01-19T04:06:50.608124Z",
"updated_at": "2026-01-19T04:06:50.608124Z",
"expires_at": "0001-01-01T00:00:00Z"
}
]
}
}评价此篇文章