Dify 接入

文档由

1折AI

维护。

来源、商业关系与纠错说明

。发现错误，请向

[email protected]

提供页面地址与可核查依据，不要发送密钥或账号资料。

Dify 用户可通过官方 OpenAI-API-compatible 模型插件配置 1折AI 的 OpenAI 兼容接口。先验证一个文本模型，再用于工作流；不需要安装来路不明的第三方插件。

准备

• 可以安装模型插件的 Dify 工作区。
• 自己的 1折AI API 密钥，以及该密钥有权限调用的模型 ID。到控制台查看。
• 账户有足够的可用额度。保存模型时的验证请求及应用测试可能产生正常 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 模板，然后在 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、工具调用、视觉和知识库检索尚未验证；请使用自己的限额密钥完成首次测试。

官方插件源码 · Dify 插件市场

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. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.