文件上传

文件上传

更新时间：2025-05-15

POST

https://qianfan.baidubce.com/v2/app/conversation/file/upload

调试

该接口用于在对话中上传文件供大模型处理，文件的有效期为7天并且不超过对话的有效期。一次只能上传一个文件。

权限说明

调用本API，需使用API Key鉴权方式。Authorization的值为Bearer <API Key>。获取API Key流程，请查看授权。

请求参数

Headers 参数

除公共头域外，无其它特殊头域

Body 参数

file string

待上传的文件，仅支持单个文件上传，支持xlsx、json、jsonl、png、 jpg、jpeg、pdf、 wav、 docx、csv、txt、dcm、gz、mha、tif、tiff、webp、heic、gz、mp3、pcm、m4a、amr、zip格式，最大100MB。file和file_url必需有一个，如果都存在，file会生效

可选

app_id string

app_id，来源于个人空间-应用-应用ID

必选

file_url string

待上传的文件url，为避免安全问题，不能为内网地址。file和file_url必需有一个，如果都存在，file会生效

可选

conversation_id string

本轮对话id，本文件只对该conversation_id有效。

必选

请求结构

POST /v2/app/conversation/file/upload  HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: mutlipart/form-data

file=待上传的文件
app_id="c5c7bfa8-97f6-48c0-97ac-689d1f6df6be"
conversation_id="1fdc9182-de2d-4c56-bf64-a72d98c2b59f"

示例代码

curl

curl --location 'https://qianfan.baidubce.com/v2/app/conversation/file/upload' \
--header 'Authorization: Bearer <API Key>' \
--form 'file=文件二进制流' \
--form 'app_id="85036d8f-239c-469c-b342-b62ca9d696f6"' \
--form 'conversation_id="355a4f4e-a6d8-4dec-b840-7075030c6d22"'

返回响应

Headers 参数

除公共头域外，无其它特殊头域

返回参数

id string

已上传文件id，该id后续可以在大模型对话接口的file_ids字段中填入。

必选

request_id string

request_id

必选

conversation_id string

本轮对话id，可以用于后续调用，有效期为7天。

必选

正确响应示例错误响应示例

JSON

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"
}