上传知识库文档

POST

https://api.gugudata.com/ai/knowledge-bases/default/documents

上传 PDF、TXT、Markdown、HTML 或 DOCX 文档，建立可供问答使用的私有知识库。

单次最多上传 5 个文件，单文件最大 20 MiB。knowledge_base_id 用于区分知识库，tenant_id 可作为客户侧业务分组，metadata 可记录业务来源。

鉴权支持 multipart、Query、AppKey / X-GUGUDATA-APPKEY / X-API-Key Header 和 Bearer。上传成功后返回文档标识与处理结果。

请求参数

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.gugudata.com/ai/knowledge-bases/default/documents' \
--form 'appkey="请前往 https://www.gugudata.com 购买"' \
--form 'files=@"postman-cloud:///1eea08cd-af1c-4f50-accb-3d1b56640da0"' \
--form 'tenant_id="default"' \
--form 'metadata="{}"' \
--form 'replace_existing="false"'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{}

修改于 2026-09-14 03:30:36

AI 文档字段结构化解析（同步文本）

AI 文档知识库问答