上传文件

POST

/api/open/v4/butler/files

上传原始文件到知识库，返回可供知识任务使用 fileId 和 fileUrl。

支持的文件类型：

PDF: application/pdf

Word: application/vnd.openxmlformats-officedocument.wordprocessingml.document

Excel: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

TXT: text/plain

Markdown: text/markdown, text/mdx

HTML: text/html

CSV: text/csv

约束限制：

文件大小限制：15MB

文件名长度限制：256字符

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://c2.xinheyun.com/api/open/v4/butler/files' \
--header 'Cookie;' \
--form 'file=@""' \
--form 'purpose="knowledge"' \
--form 'fileName="产品手册.pdf"'

返回响应

🟢200

application/json

上传成功

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "fileId": "0d4e6d3c-4687-4cd8-95b7-2006565c66c2",
        "fileName": "测试文件.md",
        "mimeType": "text/markdown",
        "sizeBytes": 2344,
        "purpose": "knowledge",
        "fileUrl": "https://newqa-3chat.frp.newcoretech.com/openapi/24268a6c-b0a4-414d-b03b-74ed200d31b6/0d4e6d3c-4687-4cd8-95b7-2006565c66c2/%E6%B5%8B%E8%AF%95%E6%96%87%E4%BB%B6.md",
        "sha256": "a5450fbff557fef5dc28266e28268823a75a47b228707e5b1a77039ab2a24f5e",
        "createdAt": 1778208611781
    }
}

🟠400

🟠413

🟠415

修改于 2026-05-08 06:15:16

创建消息

创建知识处理任务