上传附件

POST

/v1/knowledge/attachments

上传文档文件（multipart/form-data）。

文件类别	常见格式	说明
纯文本	`.txt`, `.json`,`josnl`	结构化或非结构化文本，适合全文检索
办公文档	`.doc`, `.docx`	Microsoft Office 系列（部分支持解析文字/表格/备注）
PDF 文档	暂不支持	可解析文字层（扫描版需 OCR 支持）
标记语言	`.md`	结构化文本，保留标题/列表等语义

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.peakkai.ai/v1/knowledge/attachments' \
--header 'Authorization: Bearer {{api_key}}' \
--form 'file=@"/Users/tangchanghao/Downloads/餐饮行业8000问.txt"' \
--form 'kid="{kid}"'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "id": 0,
        "kid": "string",
        "docId": "string",
        "docName": "string",
        "docType": "string",
        "remark": "string",
        "ossId": 0,
        "docUrl": "string",
        "picStatus": 0,
        "picAnysStatus": 0,
        "vectorStatus": 0,
        "vectorFailReason": "string",
        "estimateTokens": 0,
        "actualTokens": 0,
        "vectorCostMs": 0,
        "estimateFinishTime": "string",
        "progressPercent": 0,
        "lastUpdateTime": "string",
        "estimateCost": 0
    }
}

🟠401

修改于 2026-11-02 08:23:18

查询附件列表

获取附件处理状态