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

# Dify API 快速开始

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

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/api-reference/guides/get-started)。

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

## 获取 API 密钥

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

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

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

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

  知识库密钥的权限范围更大，可访问创建该密钥的账户下所有可见的知识库，需格外妥善保管。详见 [知识库 API](/zh/api-reference/guides/knowledge)。

## 发起第一个请求

每个请求都通过 Bearer 令牌携带密钥。Dify Cloud 的基础 URL 为 `https://api.dify.ai/v1`；自部署时，替换为你实例的 API 基础 URL。

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

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

```bash theme={null}
curl https://api.dify.ai/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 密钥，其接口属于另一组，第一个请求可改试 [获取知识库列表](/zh/api-reference/knowledge-bases/list-knowledge-bases)。

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

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

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