POST
/
api
/
knowledgebases
curl --request POST \
  --url https://app.pathors.com/api/knowledgebases \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "name": "<string>",
  "type": "<string>",
  "embeddingModelName": "<string>",
  "chunkSize": 123,
  "chunkOverlap": 123
}'

​
创建知识库

为您的项目创建新的知识库。目前每个项目仅限创建一个知识库。

​
接口

POST /api/knowledgebases

​
请求头

​
x-api-key
string
required

用于认证的项目 API 密钥

​
请求体

​
name
string
required

知识库名称

​
type
string
required

知识库类型。目前仅支持 “pgvector”

​
embeddingModelName
string
required

要使用的嵌入模型。可选值：

  • text-embedding-ada-002
  • text-embedding-3-small
  • text-embedding-3-large
​
chunkSize
number

文本分块的最大大小（以字符为单位）。默认为 500

​
chunkOverlap
number

相邻文本块之间的重叠字符数。默认为 50

请求示例：

{
  "name": "我的知识库",
  "type": "pgvector",
  "embeddingModelName": "text-embedding-3-small",
  "chunkSize": 500,
  "chunkOverlap": 50
}

​
响应

成功的请求将返回 201 状态码和一条成功消息。

响应示例：

{
  "message": "Knowledgebase created successfully"
}

​
错误响应

状态码描述
400无效的请求体或验证错误
401无效的 API 密钥
500内部服务器错误

​
使用说明

  • 每个项目只能创建一个知识库
  • 创建后无法更改嵌入模型
  • 根据需求选择嵌入模型：
    • text-embedding-ada-002：传统模型，通用性好
    • text-embedding-3-small：更快速，更高效
    • text-embedding-3-large：性能最强，质量最佳

​
相关接口