获取文件列表
获取指定文件列表的信息，返回文件详细信息列表
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
文件ID列表，用于指定需要获取信息的文件。
文件的唯一标识数组，用于批量查询文件详细信息。
显示子属性
隐藏子属性
文件用途，用于筛选特定用途的文件。
文件的使用目的标识。
对话ID，用于筛选特定对话中的文件。
对话的唯一标识，用于关联对话上下文中的文件。
消息ID，用于筛选特定消息中的文件。
消息的唯一标识，用于关联消息中的文件。
目录路径，用于筛选特定目录下的文件。
文件所在的目录位置。
文件路径，用于筛选特定路径的文件。
文件的完整路径标识。
返回结果数量限制，用于分页查询。
限制单次查询返回的文件数量。
排序方式。
可选值：
asc：升序排列
desc：降序排列
游标标识，用于分页查询的起始位置。
用于获取指定位置之后的文件列表。
POST /v2/app/files/get HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"file_ids": [
"string"
],
"purpose": "string",
"conversation_id": "string",
"message_id": "string",
"directory": "string",
"path": "string",
"limit": 0,
"order": "string",
"after": "string"
}示例代码
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-abc123"
]
}'返回响应
响应码，表示请求处理结果的状态标识。
响应消息，提供关于请求处理结果的详细说明。
返回数据，包含请求的响应结果和文件详细信息。
显示子属性
隐藏子属性
请求ID，请求的唯一标识，用于追踪和调试。
返回对象类型，标识响应数据的类型。
文件信息列表，包含查询到的所有文件的详细信息。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
对话ID，对话的唯一标识，用于关联文件所属的对话。
文件ID，文件的唯一标识，用于识别和访问文件。
消息ID，消息的唯一标识，用于关联文件所属的消息。
文件元数据，包含文件的扩展信息和处理状态。
显示子属性
隐藏子属性
BOS地址，文件在百度对象存储中的访问地址。
BOS桶名，文件所在的百度对象存储桶名称。
BOS对象名，文件在百度对象存储中的对象名称。
简介，文件内容的简短摘要说明。
状态，文件处理状态标识。
BOS地址，文件在百度对象存储中的访问地址。
BOS桶名，文件所在的百度对象存储桶名称。
BOS对象名，文件在百度对象存储中的对象名称。
简介，文件内容的简短摘要说明。
状态，文件处理状态标识。
文件类型，标识文件的MIME类型。
文件路径，文件的完整路径标识。
临时访问链接，用于临时访问文件的预签名URL。
使用目的，标识文件的用途类型。
文件大小，以字节为单位的文件大小。
BOS链接，文件在百度对象存储中的完整存储位置。
创建时间，文件创建的时间，格式为ISO8601，时区为UTC。
过期时间，文件过期的时间，格式为ISO8601，时区为UTC。
更新时间，文件最后更新的时间，格式为ISO8601，时区为UTC。
预览地址，用于在线预览文件的URL地址。
文件名，文件的原始名称。
目录，文件所在的目录位置。
{
"code": "success",
"message": "",
"result": {
"data": [
{
"conversation_id": "",
"created_at": "2026-01-12T07:17:38.097102Z",
"directory": "/./",
"expires_at": "0001-01-01T00:00:00Z",
"file_id": "file-abc123",
"filename": "abc123.md",
"message_id": "",
"metadata": {
"xmind_bos_url": "https://some-bos.bj.bcebos.com/some-path/abc-123.md",
"xmind_bucket_name": "some-bos",
"xmind_object_name": "some-bos/abc-123.md",
"xmind_short_summarize": "### 核心主旨 ....",
"xmind_status": "success"
},
"mime_type": "text/markdown",
"path": "/健康计划_2025-11-06.md",
"presigned_url": "https://agi-dev-platform-file.bj.bcebos.com/files/a808e1c162384b6784cf15ea7da11b73/uploads/file-abc123_xxxxxxxxxxx",
"purpose": "chat",
"size": 4386,
"storage_location": "bos://agi-dev-platform-file/files/a808e1c162384b6784cf15ea7da11b73/uploads/abc123.md",
"updated_at": "2026-01-12T07:17:47.846443Z",
"viewer_url": "http://localhost:8080/api/v1/viewer/file-abc123?ts=1768202307\\u0026sig=72f9cd0c5167c00be4b6591b210ef2d929cb7cebc1e1838c6c2eb8f8083343bc"
}
],
"object": "list",
"request_id": "bbe81317-xr13-5n86-5b94-3e55985c846d"
}
}