> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dify API 快速开始

> 获取 API 密钥、发起第一个请求，并找到你的应用类型对应的接口

在 Dify 中发布的每个应用都同时是一个 REST API，知识库也是如此。你可在自己的后端用 API 密钥调用终端用户所使用的同一个应用。

## 获取 API 密钥

<Warning>
  只在后端调用 API。嵌入前端代码或客户端应用中的密钥可能被提取和滥用。
</Warning>

* 应用密钥：在应用内部创建 API 密钥。该密钥仅作用于这一个应用，且一个密钥可服务你的所有终端用户。

  <Info>
    调用时以每人各自的 `user` 值区分不同的人。详见 [终端用户身份](/zh/3.13.x/develop/api/guides/end-user-identity)。
  </Info>

* 知识库密钥：打开 **知识库** 页面，点击右上角的 **服务 API**，在此创建 API 密钥。

  可将密钥的访问范围 [限定为集成需要访问的知识库](/zh/3.13.x/develop/api/guides/knowledge#scoped-api-keys)。

## 发起第一个请求

每个请求都通过 Bearer 令牌携带密钥。基础 URL 是你部署的 API 端点（例如 `https://api.example.com/v1`），可在应用的 API 访问页面复制。

最快的第一个请求无需写代码：打开 [获取应用基本信息](/zh/3.13.x/develop/api/applications/get-app-info)，点击 **试一试**，把密钥粘贴到 **Authorization** 字段，再按 **发送**。它适用于所有应用类型。

在终端中发起同样的调用：

```bash theme={null}
curl https://api.example.com/v1/info \
  -H "Authorization: Bearer $DIFY_API_KEY"
```

收到如下响应即说明密钥有效，同时能看到它所属的应用：

```json theme={null}
{
  "name": "My Chat App",
  "description": "A helpful assistant",
  "tags": ["assistant"],
  "mode": "chat",
  "author_name": "Dify Team"
}
```

使用知识库 API 密钥时，按访问范围选择首次调用的接口：

* **限定范围的密钥**：先 [从 Dify 复制](/zh/3.13.x/develop/api/guides/knowledge#knowledge-base-id) 范围内某个知识库的 ID，再调用 [获取知识库详情](/zh/3.13.x/develop/api/knowledge-bases/get-knowledge-base)。
* **可访问所有知识库的密钥**：调用 [获取知识库列表](/zh/3.13.x/develop/api/knowledge-bases/list-knowledge-bases)。

## 找到你的应用类型对应的接口

每种应用类型的完整 API 见其概览页：

* [Chatflow](/zh/3.13.x/develop/api/guides/chatflow)（`advanced-chat`）
* [Workflow](/zh/3.13.x/develop/api/guides/workflow)（`workflow`）
* [Agent](/zh/3.13.x/develop/api/guides/agent)（`agent`）
* [Chatbot 和旧版 Agent](/zh/3.13.x/develop/api/guides/chat)（`chat`、`agent-chat`）
* [文本生成应用](/zh/3.13.x/develop/api/guides/completion)（`completion`）
* [知识库](/zh/3.13.x/develop/api/guides/knowledge)