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

# Dify 接入 APIONE

> 为工作区添加模型，在 Chatbot 与工作流中调用 APIONE。

Dify 的模型供应商配置属于工作区设置。配置成功后，还需要在应用的模型节点中显式选择 APIONE 模型。

## 添加模型

1. 进入工作区 **Settings → Model Provider**。
2. 查找 **OpenAI-API-compatible**；如尚未安装，按当前 Dify 界面从官方插件市场添加。
3. 点击 **Add Model**，模型类型选择 LLM。
4. 模型 ID 填入 APIONE 当前可用的 Chat Completions 模型。
5. API Key 填入 APIONE 密钥，API Endpoint / Base URL 填入 `https://api.apione.ai/v1`。
6. 上下文窗口、输出上限等字段依据该模型参数填写，然后保存。

如果插件字段明确要求完整请求地址，应使用 `https://api.apione.ai/v1/chat/completions`，不要让插件重复拼接路径。

![Dify 添加兼容模型的表单，API Base URL 填写 https://api.apione.ai/v1](https://mintcdn.com/apione/bPc0c0uWIOMLKxcC/images/integrations/screenshots/dify-apione-add-model-v2.png?fit=max\&auto=format\&n=bPc0c0uWIOMLKxcC\&q=85\&s=49da623bcf7877c0b03f5a62790b55db)

Dify 添加 APIONE 兼容模型的配置示例。模型 ID 与参数请按实际可用模型填写。

## 在应用中验证

新建 Chatbot，或打开工作流的 LLM 节点，选择刚添加的模型。先运行只有文本输入的最小流程，确认实际输出，再加入知识库、工具与多模态输入。

## 常见问题

* **保存时验证失败**：检查 Dify 后端或插件运行环境的出站网络、密钥和模型 ID。
* **工作区能看到但应用仍调用旧模型**：重新选择 LLM 节点并保存应用配置。
* **知识库检索失败**：Embedding、Rerank 与对话模型是独立能力，需要分别配置支持的服务。
* **插件和自托管环境差异**：以当前 Dify 与供应商插件版本的字段定义为准。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.