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

# Dify 集成

> 在 Dify 中配置 AGICTO API 的 OpenAI 兼容模型

你可以在 Dify 中添加 OpenAI 兼容模型供应商，并使用 AGICTO API 调用模型。Dify 的模型供应商配置使用 `API Base` 字段，不需要填写 `/v1` 路径。

## 配置值

| 字段       | 值                        |
| -------- | ------------------------ |
| 供应商      | OpenAI-compatible        |
| 凭据名称     | `agicto` 或便于团队识别的名称      |
| API Key  | 你的 AGICTO API Key        |
| 组织 ID    | 留空                       |
| API Base | `https://api.agicto.cn`  |
| 验证模型     | 从模型列表复制的模型名，例如 `gpt-5.5` |
| API 协议   | Chat Completions         |

## 配置步骤

<Steps>
  <Step title="打开模型供应商">
    在 Dify 控制台进入 **Settings**，然后打开 **模型供应商**。
  </Step>

  <Step title="添加 OpenAI 兼容供应商">
    在模型列表中找到 **OpenAI-compatible**，点击 **添加 API 密钥** 或 **配置**。
  </Step>

  <Step title="填写 API 密钥授权配置">
    凭据名称填 `agicto`，API Key 填你的 AGICTO API Key，组织 ID 留空。
  </Step>

  <Step title="填写 API Base 和验证模型">
    API Base 填 `https://api.agicto.cn`。从 <a href="https://agicto.com/model">模型列表</a> 复制模型名，填入验证模型。
  </Step>

  <Step title="选择 API 协议并保存">
    API 协议选择 **Chat Completions**，然后点击 **保存**。
  </Step>

  <Step title="发送测试消息">
    创建一个简单应用，发送一条测试消息确认调用成功。
  </Step>
</Steps>

## 排查

* 如果认证失败，检查 API Key 是否完整。
* 如果模型不可用，检查模型名是否从模型列表复制。
* 如果路径错误，确认 Dify 的 API Base 是否为 `https://api.agicto.cn`，不要在该字段中追加 `/v1`。
* 如果协议错误，确认 API 协议选择 **Chat Completions**。
* 如果响应慢，先换低成本模型测试链路。

<Card title="如何选择模型" icon="sliders" href="/guides/model-selection">
  按 Dify 应用场景选择聊天、向量和排序模型。
</Card>