上传文件
本接口用于上传文件（File），请求格式为 multipart/form-data。
上传成功后返回文件对象，其中 id 为文件标识，可在会话中引用。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
文件内容。单文件最大 500 MB；企业文件库配额更小时以配额为准，超过上限返回 413。
文件有效期，单位为秒。
取值：3600–7776000，超出范围时返回 400；不传时文件不过期。
POST /api/dma/v1/files HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: multipart/form-data示例代码
curl --location --request POST "https://api.dumate.cn/api/dma/v1/files" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--form 'file=@/absolute/path/to/demo2.txt' \
--form 'expires_in_seconds=3600'返回响应
资源类型标识，固定为 file。
文件标识。
上传文件通常为 node_ 前缀，会话产物为 art_ 前缀。
上传后可在 user.message 的内容块中引用文件，系统会先把文件挂载到会话再发给智能体（Agent）。支持以下三种写法：{"type": "document", "source": {"type": "file", "file_id": "node_xxx"}}、{"type": "image", "source": {"type": "file", "file_id": "node_xxx"}}、{"type": "file", "file_id": "node_xxx"}。前两种用于 PDF 文档和图片，第三种用于其他类型的文件。
文件名。
文件的 MIME 类型。
会话产物取不到类型时为 application/octet-stream。
文件大小，单位为字节。
会话产物优先取实际下载大小，与下载接口返回的字节数一致。
创建时间，RFC 3339 格式，UTC。
会话产物取不到时间时不返回该字段。
是否可下载。
过期时间，RFC 3339 格式，UTC；不过期时为 null。
文件的作用范围。
仅会话产物返回。
显示子属性
隐藏子属性
作用范围类型，固定为 session。
产物所在的会话标识。
{
"type": "file",
"id": "node_g001a1c08f2611001leua8pmtA3UaVj",
"filename": "demo2.txt",
"mime_type": "text/plain",
"size_bytes": 27,
"created_at": "2026-11-09T13:46:09Z",
"downloadable": true,
"expires_at": "2026-11-09T14:46:09Z"
}评价此篇文章