文件上传
更新时间：2025-12-19
POST
https://qianfan.baidubce.com/v2/agent/file/upload
本接口用于上传文件，支持文本、表格、图片及音频等多种模态的数据输入。上传成功后返回的文件 ID 可用于后续的对话或文件解析处理。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
form-data
agent_code
string
支持以下Agent：
- code_interpreter：代码解释器
- browser_use：浏览器使用
- deepresearch：深度研究
必选
conversation_id
string
对话ID，对话创建接口中获取。
conversation_id由特定agent_code生成时，仅限在该智能体（Agent）使用，禁止跨智能体调用。
必选
file
string
二进制文件内容（与file_url二选一），文件上传数量 ≤ 10个。
- 文本文件 (.doc, .docx, .txt, .pdf, .ppt, .pptx)
• txt：单个文件 ≤ 10MB
• pdf：单个文件 ≤ 100MB 且 ≤ 3000页（超出页数部分自动忽略）
• ppt/.pptx：≤ 400页（超出页数部分自动忽略）
• doc/.docx：单个文件 ≤ 100MB 且 ≤ 2500页（超出页数部分自动忽略） - 表格文件 (.xlsx, .xls)
• 单文件 ≤ 100 MB
• 每行 ≤ 15 万字（以字符数计算）
• 仅支持 1 个 Sheet
• 支持编码：UTF-8, GBK, GB2312, GB18030, ASCII - 图片类 (.png, .jpg, .jpeg, .bmp)
• 单张图片 ≤ 10 MB - 音频类 (.wav, .pcm)
• 单文件 ≤ 10 MB
可选
file_url
string
文件URL（与file二选一）
需为公网可访问的 URL，文件格式限制同file说明。
可选
请求结构
POST /v2/agent/file/upload HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: multipart/form-data
[form-data]
agent_code="deepresearch"
conversation_id="de65bd4c-****-****-8435-9f99e671d18b"
file="@mydata.txt"示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/agent/file/upload" \
-H "Authorization: Bearer <API Key>" \
-H "Content-Type: multipart/form-data" \
-F "agent_code=deepresearch" \
-F "conversation_id=de65bd4c-****-****-8435-9f99e671d18b" \
-F "file=@mydata.txt"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
request_id
string
请求的唯一标识 ID
必选
result
object {2}
返回结果对象
必选
显示子属性
隐藏子属性
file_id
string
上传成功后的文件 ID
必选
conversation_id
string
当前对话的 ID，与请求参数一致
必选
响应示例
{
"request_id": "96d19150-****-****-bcae-38302898a9d5",
"result": {
"file_id": "file-***qs6p",
"conversation_id": "de65bd4c-****-****-8435-9f99e671d18b"
}
}