文件上传
更新时间：2024-11-13
接口描述
该接口用于在对话中上传文件供大模型处理，文件的有效期为7天并且不超过对话的有效期。一次只能上传一个文件。
在线调试
百度智能云千帆提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用。
权限说明
Authorization需要填写密钥。
接口定义
| Path | /v2/app/conversation/file/upload |
|---|---|
| Method | POST |
| Content-Type | multipart/form-data |
| Authorization | 请求签名(此签名为应用工作台密钥) |
请求结构
POST /v2/app/conversation/file/upload HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: mutlipart/form-data
file="北京小学.xlsx"
app_id="c5c7bfa8-97f6-48c0-97ac-689d1f6df6be"
conversation_id="1fdc9182-de2d-4c56-bf64-a72d98c2b59f"请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| app_id | string | 是 | app_id，来源于个人空间-应用-应用ID |
| file | file | 是 | 文件，仅支持单个文件上传，支持xlsx、json、jsonl、png、jpg、jpeg、pdf、wav、docx、csv、txt格式，最大20MB |
| conversation_id | string | 是 | 本轮对话id，本文件只对该conversation_id有效。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段 | 类型 | 必然存在 | 说明 |
|---|---|---|---|
| request_id | string | 是 | request_id |
| id | string | 是 | 已上传文件id，该id后续可以在大模型对话接口的file_ids字段中填入。 |
| conversation_id | string | 是 | 对话id |
请求curl 示例
curl --location 'https://qianfan.baidubce.com/v2/app/conversation/file/upload' \
--header 'Authorization: Bearer authorization string' \
--form 'file=@"GBSJEEB-5/test.jsonl"' \
--form 'app_id="85036d8f-239c-469c-b342-b62ca9d696f6"' \
--form 'conversation_id="355a4f4e-a6d8-4dec-b840-7075030c6d22"'正确响应示例
HTTP/1.1 200 OK
{
"request_id": "355a4f4e-a6d8-4dec-b840-7075030c6d22",
"id": "1a1385ca-91ff-4b71-bb2a-048db17507c6",
"conversation_id": "355a4f4e-a6d8-4dec-b840-7075030c6d22"
}错误响应示例
HTTP/1.1 400
{
"request_id": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
"code": "InvalidRequestArgumentError",
"message": "参数校验失败"
}