Dify 接入教程
搭 AI 应用和工作流的平台，装一个 OpenAI 兼容插件就能用樱桃茶的模型
- 接口：OpenAI Chat Completions
- 地址写法：写到 /v1（https://gpt.cherrychat.org/v1）
- 推荐模型：gpt-6.1-sol、deepseek-v4-flash
- 平台：网页
接入步骤
安装 OpenAI-API-compatible 插件
进入「集成」→「模型供应商」（旧版：右上角头像 →「设置」→「模型供应商」），在「安装模型供应商」里搜索「OpenAI-API-compatible」并安装。
添加模型
在 OpenAI-API-compatible 卡片上点「添加模型」，「模型类型」选 LLM，然后填下面几项。
- 模型名称：gpt-6.1-sol（填模型 ID，不是显示名）
- API Key：sk-你的密钥
- API Base URL：https://gpt.cherrychat.org/v1（写到 /v1，末尾不要再加 /）
填能力参数
「对话类型」选 Chat；「模型上下文长度」默认只有 4096，按「模型价格」页改大（例如 128000）；「最大 token 上限」可填 8192；「函数调用类型」选「工具调用」（Tool Call），Agent 和工作流才能用工具；「视觉支持」只给能看图的模型选支持。
保存并设为默认
点保存，Dify 会先校验 key 和地址。成功后点右上角「默认模型」，把「系统推理模型」选成它；在应用或工作流的 LLM 节点里也能直接选。
知识库要用的 Embedding（可选）
知识库需要向量模型时，再点一次「添加模型」，「模型类型」选 Text Embedding，模型名称填 text-embedding-3-small，API Key 和 API Base URL 同上。
容易踩的坑
- API Base URL 写到 /v1（https://gpt.cherrychat.org/v1），末尾不要多一个 /，也不要写到 /chat/completions。
- 「模型名称」填模型 ID（全小写，和模型价格页一致），不是随便起的显示名；显示名填在「模型显示名称」里。
- 「模型上下文长度」默认只有 4096，不改的话长文档和多轮对话会被截断。
- 自部署的 Dify 要确认服务器能访问 https://gpt.cherrychat.org；Docker 里的 Dify 走的是服务器自己的网络。
报错 → 原因 → 怎么办
| 看到的报错 | 原因 | 怎么办 |
|---|---|---|
| 保存时提示凭据无效 / 401 | API Key 复制错了、带了空格，或这把 key 已停用 | 到 API 页「我的密钥」重新复制后再保存 |
| 保存时报 404 | API Base URL 少了 /v1、末尾多了 /，或写成了 https://gpt.cherrychat.org/v1/chat/completions | 改成 https://gpt.cherrychat.org/v1 |
| 提示模型不存在 | 「模型名称」填了显示名或拼错 | 按模型价格页逐字填写模型 ID，例如 gpt-6.1-sol |
| 自部署时一直连接超时 | Dify 所在服务器访问不到 https://gpt.cherrychat.org | 在服务器上运行 curl https://gpt.cherrychat.org/v1/models 检查网络，能返回一段 JSON（哪怕是报错）即为连通 |
| 报 402 或「余额不足」（Claude 格式显示 billing_error） | 账户积分不够付这次调用。API 调用只扣积分，会员卡和无限卡都不抵扣 | 到樱桃茶·智域GPT 的「商店」充值任意金额，几秒后重试即可 |
| 报 429 Too Many Requests | 请求太快：默认每把 key 每分钟最多 120 次，每个账号同时最多 8 个请求 | 调低工具里的并发数或每秒请求数，按提示的 Retry-After 秒数等一等再试；多数工具会自动重试 |
教程核对于 2026-11-02。工具界面改版后可能和这里略有不同，以官方文档为准。
Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成，请仔细甄别
