上传聊天附件

POST

/nb/v1/chat/attachments/upload

最后修改时间：2026-09-23 01:32:19

以 multipart/form-data 上传聊天附件（files 字段，可多文件）。上传成功后返回上传摘要（summary）与每个文件的引用信息
文件引用中的 url 为站内路径，presigned_url 为可下载的预签名地址，可传入 /nb/v1/chat/run 的 attachments 参数

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://localhost:5013/api/nb/v1/chat/attachments/upload' \
--header 'Authorization: Bearer <token>' \
--form 'files（文件）=@"C:\\Project\\nexent\\.cursor\\how-openviking-skill-works.md"'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "message": "Processed 1 files",
    "requestId": "23bc4ee2-f625-4a3a-a637-a46ffc3c0bb4",
    "summary": {
        "total": 1,
        "uploaded": 1,
        "failed": 0
    },
    "files": [
        {
            "object_name": "attachments/44dc6fa5-bfce-42b0-b3a4-7dadd3309edb/20260622093237_fdbd6acd7a554802bcda0f0096440a35.md",
            "name": "how-openviking-skill-works.md",
            "type": "file",
            "size": 6946,
            "url": "/nexent/attachments/44dc6fa5-bfce-42b0-b3a4-7dadd3309edb/20260622093237_fdbd6acd7a554802bcda0f0096440a35.md",
            "description": "",
            "presigned_url": "http://localhost:5013/api/nb/v1/file/fetch?presigned_url=http%3A%2F%2Fnexent-minio%3A9000%2Fnexent%2Fattachments%2F44dc6fa5-bfce-42b0-b3a4-7dadd3309edb%2F20260622093237_fdbd6acd7a554802bcda0f0096440a35.md%3FX-Amz-Algorithm%3DAWS4-HMAC-SHA256%26X-Amz-Credential%3D9ff15e1c7f980659e0f87421%252F20260622%252Fcn-north-1%252Fs3%252Faws4_request%26X-Amz-Date%3D20260622T093237Z%26X-Amz-Expires%3D86400%26X-Amz-SignedHeaders%3Dhost%26X-Amz-Signature%3D4fe276616844e8faad8f0c694c462b6cebea9c20f0765077b3fb135448db1f61"
        }
    ]
}

修改于 2026-09-23 01:32:19

聊天接口：jsonrpc 非流式

开始流式聊天