[Dify] 知识库 API 使用指南：如何通过 API 灵活插入文档条目

<think>好的，用户现在想查找Dify知识库API的具体位置或文档地址。我需要先回顾之前的对话和相关引用，确保准确回答。首先，用户之前的问题是关于如何用Dify API创建知识库，我提供了详细的步骤和示例代码。现在用户进一步询问API入口和文档的位置。根据引用内容，Dify的API通常通过其RESTful接口访问，但用户可能需要具体的URL和文档链接。检查引用[3]，其中提到Dify的安装和配置步骤，包括克隆源码和启动容器。这可能意味着Dify的文档可能在其官方GitHub仓库或官方网站。引用[2]提到Dify的sandbox机制和高级应用，但没有直接给出API文档地址。引用[1]和[4]涉及知识库配置，但同样没有API入口信息。 考虑到Dify是开源项目，官方文档应在线提供。用户可能需要访问Dify的官方文档网站，通常为https://docs.dify.ai/，这里会有API部分的详细说明。此外，在安装Dify后，本地部署的实例可能提供SwaggerUI或API文档入口，如http://localhost/service/api，但具体端口取决于部署方式。 需要确认用户是否已经部署了Dify，如果是本地部署，API入口可能是本地地址加特定路径。同时，建议用户查阅官方文档获取最新信息，因为版本更新可能影响API路径。另外，用户可能需要API密钥进行身份验证，这在之前的回答中已经提到过，所以需要提醒用户确保已获取正确的API密钥。 总结，用户需要的是Dify知识库API的具体入口和文档地址，应指向官方文档和可能的本地实例路径，并提醒注意版本和部署方式的影响。</think>### Dify 知识库 API 入口及文档说明 #### 1. 官方文档地址 Dify 的 **API 文档** 集成在其官方文档中，可通过以下地址访问： ``` https://docs.dify.ai/v/zh-hans/guides/apis ``` 该文档包含完整的 API 接口说明，涵盖知识库管理、模型调用、数据上传等操作[^3]。 #### 2. API 入口基础路径 Dify 的 API 入口基础路径根据部署方式不同有所差异： - **默认部署**（本地或云服务器）： ``` http://<your_dify_domain>/v1 ``` - **Docker 部署**（默认端口）： ``` http://localhost/service/api/v1 ``` 具体端口需根据 `docker-compose.yml` 中的配置调整[^3]。 #### 3. 知识库相关 API 路径 | 功能 | 请求方法 | 路径 | |----------------|----------|------------------------------| | 创建知识库 | POST | `/knowledge_bases` | | 查询知识库列表 | GET | `/knowledge_bases` | | 更新知识库 | PUT | `/knowledge_bases/{kb_id}` | | 删除知识库 | DELETE | `/knowledge_bases/{kb_id}` | #### 4. 快速验证 API 可通过以下命令验证 API 连通性（需替换 `YOUR_API_KEY`）： ```bash curl -X GET "http://localhost/service/api/v1/knowledge_bases" \ -H "Authorization: Bearer YOUR_API_KEY" ``` #### 5. 文档关键内容 在官方文档中重点关注以下章节： - **知识库管理 API**：包含字段定义和请求示例 - **认证方式**：API Key 的使用规范 - **速率限制**：不同套餐的 API 调用限制 - **错误代码**：包含 `401 Unauthorized`, `404 Not Found` 等常见错误说明[^3][^4] ### 示例：获取知识库列表 ```python import requests url = "http://localhost/service/api/v1/knowledge_bases" headers = {"Authorization": "Bearer YOUR_API_KEY"} response = requests.get(url, headers=headers) print(response.json()) ```