--- title: Dify 接入 description: 使用 Dify 官方 OpenAI-API-compatible 插件配置 1折AI，完成模型配置、对话测试和首次调用排查。 --- Dify 用户可通过官方 **OpenAI-API-compatible** 模型插件配置 1折AI 的 OpenAI 兼容接口。先验证一个文本模型，再用于工作流；不需要安装来路不明的第三方插件。 ## 准备 - 可以安装模型插件的 Dify 工作区。 - 自己的 1折AI API 密钥，以及该密钥有权限调用的模型 ID。到[控制台](https://1zheai.com/console)查看。 - 账户有足够的可用额度。保存模型时的验证请求及应用测试可能产生正常 API 费用。 不要把完整密钥发送给客服、写进工作流说明、截图或公开仓库。只在 Dify 的 API Key 密钥字段中保存；使用第三方托管的 Dify 时，该实例会持有你的密钥并转发请求。 ## 添加模型 1. 在 Dify 插件市场找到 **OpenAI-API-compatible**，确认发布者为 **langgenius**。 2. 打开工作区设置中的模型供应商，找到该插件，添加 LLM 模型。 3. 按下表填写后保存。界面名称可能随 Dify 版本变化。 | 字段 | 填写方式 | | --- | --- | | Model Name / 模型名称 | 从 1折AI 控制台复制完整模型 ID，不用展示名称代替 | | API Key | 你自己的 1折AI 密钥 | | API Base URL | `https://1zheai.com/v1` | | Completion mode / 对话类型 | `Chat` | | API endpoint 中的模型名称 | 通常留空；如设置，必须与实际模型 ID 一致 | | Model context size | 按所选模型的实际能力填写；不要照抄其他模型的上下文长度 | 这里需要 `/v1`，不要填写完整的 `/v1/chat/completions`，也不要重复成 `/v1/v1`。不要套用其他客户端只填写根地址的说明。 ## 从第一次对话开始 创建一个空白聊天应用，选择刚刚保存的模型，输入「请用一句中文介绍你能做什么」。确认返回完整文本后，再验证流式输出。 到 1折AI 控制台的调用日志查看对应请求时间、模型和结果。不要只以 Dify 的“保存成功”作为应用接通的依据。首次成功后再配置工具调用、视觉输入或知识库检索，这些能力取决于具体模型与接口，不能因文本对话成功就认为全部可用。 ## 导入示例 Chatflow [下载无密钥 Chatflow 模板](/docs/downloads/1zheai-dify-chatflow.yml)，然后在 Dify Studio 选择 **Create → Import DSL file** 上传。模板为 `User Input → LLM → Answer`，DSL 版本 0.7.0，使用官方兼容插件 0.0.68。 先按上面的步骤添加自己的凭据。导入后打开 LLM 节点，确认选中自己的供应商与模型，而不是 Dify 试用模型。示例模型 ID 为 `claude-haiku-4-5-20251001`，如账户不可用，请改为自己有权限的模型，并检查能力设置。模板不包含 API 密钥，也不会提供免费调用额度。 ## 常见问题 | 现象 | 先检查什么 | | --- | --- | | 503 / No available accounts | 当前上游可能限额或没有可用容量。先看服务状态与调用日志，稍后有限重试或联系支持；不要持续高频重试，也不要反复重新生成密钥 | | 401 / 密钥无效 | 是否多了空格、密钥是否已撤销，以及是否误用了其他平台的 Key | | 404 | Base URL 是否恰好为 `https://1zheai.com/v1`；模型 ID 是否存在 | | 模型无权限或额度不足 | 当前密钥的模型限制、账户可用额度与所选模型 | | 保存通过，但应用不能调用 | 应用是否选择了正确供应商和模型；工作区服务器是否能访问 API | | 普通回答正常，流式异常 | 检查代理的 SSE 支持、插件版本以及流式 usage 设置；保留脱敏错误供排查 | | 工具调用或视觉失败 | 先确认所选模型真实支持该能力，避免仅修改插件开关强行启用 | 自托管 Dify 的请求由其服务器发出，浏览器可以打开官网不代表 Dify 服务器可以连接 API。 ## 获取接入帮助 通过官网在线客服提供 Dify 版本、插件版本、模型 ID、错误发生时间、请求 ID 和脱敏错误信息。不要发送完整 Key、客户数据或工作流中的私密提示词。 ## 验证范围 2026-10-19 使用官方插件 0.0.68，在 Dify Cloud 完成了 Haiku 文本对话和流式调用，并与网关日志对应。导出的无密钥 DSL 已在同一工作区导入为新应用。导入后复测遇到上游限额导致的 503，因此不将这一轮记为导入后运行通过。 这是一次有明确时间范围的内部测试，不是持续可用性保证。全新工作区、旧版 Dify、工具调用、视觉和知识库检索尚未验证；请使用自己的限额密钥完成首次测试。 [官方插件源码](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Dify 插件市场](https://marketplace.dify.ai/) ## English / Русский **English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support. **Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.