文件上传
更新时间:2024-04-28
接口描述
该接口用于在对话中上传文件供大模型处理,文件的有效期为7天并且不超过对话的有效期。一次只能上传一个文件。
权限说明
Authorization需要填写密钥。
接口定义
URL | /v2/app/conversation/file/upload |
---|---|
Method | POST |
Content-Type | mutlipart/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 | 是 | 文件 |
conversation_id | string | 是 | 对话id,本轮对话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": "参数校验失败"
}