上传文件
更新时间：2025-11-24
POST
https://qianfan.baidubce.com/v2/files
将本地文件上传至用户授权的BOS Bucket，上传的文件将用于模型微调、评估数据集等任务。
支持单个文件上传，文件大小不超过512MB。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
file
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格式。
必选
请求结构
POST /v2/files HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: multipart/form-data
[form-data]
purpose="fine-tune"
file="@mydata.jsonl"示例代码
请求示例
curl -X POST https://qianfan.baidubce.com/v2/files \
-H "Authorization: Bearer bce-v3/ALTAK-*********/614fb**********" \
-H "Content-Type: multipart/form-data" \
-F purpose="fine-tune" \
-F file="@mydata.jsonl"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
文件唯一标识符。
可选
object
string
固定值：file。
可选
bytes
integer
文件大小，单位字节。
可选
created_at
integer
文件上传的时间戳。
可选
filename
string
文件名称。
可选
purpose
string
文件用途，对应请求中的purpose字段。
可选
JSON
{
"id": "file-*****jcetb",
"object": "file",
"bytes": 515,
"created_at": 1763623134,
"filename": "mydata.jsonl",
"purpose": "fine-tune"
}JSON
{
"error": {
"code": "invalid_upload_file",
"message": "missing file parameter",
"type": "invalid_request_error"
},
"id": "as-*****96vyn"
}错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。