上传文件
更新时间：2026-09-10
POST
https://api.dumate.cn/api/v1/files
本接口用于上传文件（File），上传成功后返回文件标识 fileID。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
file
string
文件数据，二进制内容。
大小：单个文件不超过 100 MB。
必选
sessionId
string
文件所属会话（Session）的标识。
在会话消息 user.message 中传入 file_id 前，必须使用当前会话的 sessionId 上传文件；仅已托管但未绑定当前会话的 fileID 不能在该会话中引用，需重新上传并使用新返回的 fileID。
可选
mimeType
string
文件 MIME 类型，示例为 text/plain。
可选
请求结构
POST /api/v1/files HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: multipart/form-data
file=@document.txt
sessionId={sessionId}
mimeType=text/plain示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/v1/files" \
--header "Authorization: Bearer <YOUR_API_KEY>" \
--form "file=@document.txt" \
--form "sessionId=ses_demo_a18d0f" \
--form "mimeType=text/plain"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
fileID
string
上传成功后生成的文件标识。
可选
响应示例
{
"fileID": "file-01a00b4b7718758ba1410a23e9522dc7"
}评价此篇文章