文件操作
上传文件
适用于:Chatflow、Workflow、新 Agent、聊天助手、Agent、文本生成应用。
上传文件并返回其 id,供后续请求引用。文件归上传它的终端用户所有:只有携带相同 user 的请求才能引用该文件。
应用实际能使用哪些文件类型,取决于它的文件上传设置;可通过 获取应用参数 读取。
POST
上传文件
Authorizations
Body
multipart/form-data
文件上传请求。需要 multipart/form-data 格式。
Response
文件上传成功。
唯一文件 ID。
在 Agent 和工具场景中附加文件时内部使用的不透明文件引用。通过此端点上传的文件始终为 null。
文件名。
文件大小(字节)。
文件扩展名。
文件的 MIME 类型。
上传时间戳(Unix 纪元秒)。
文件的预览 URL。
文件的签名下载 URL。
文件的原始 URL。
未使用,始终为 null。
关联的租户 ID。
关联的会话 ID。
未使用,始终为 null。
Last modified on September 1, 2026