New API 使用指南
Dify 配置教程
在 Dify 中接入 CherryIN 模型,用于聊天助手、工作流和应用编排
什么是 Dify?
Dify 是一个常见的 AI 应用编排平台,可以用来搭建聊天机器人、工作流、Agent 和 API 应用。
CherryIN 可以通过 Dify 的 OpenAI 模型提供商接入。
开始之前
请先确认:
- 你已经拿到 CherryIN API Key
- 你在 Dify 工作区中拥有管理员或所有者权限
- 你准备好了要使用的模型 ID,例如
anthropic/claude-sonnet-4.5
权限要求
Dify 官方文档说明,只有工作区管理员和所有者才能配置模型供应商。
配置步骤
进入模型供应商
在 Dify 工作区中进入:
Settings -> Model Providers新版本 Dify 将模型供应商作为插件管理。如果你的工作区里还没有启用 OpenAI 供应商,请先安装或启用它。
配置 OpenAI 供应商
找到 OpenAI 供应商后,新增一组凭据,按下面填写:
| 字段 | 填写内容 |
|---|---|
API Key | 你的 CherryIN Key |
Custom Base URL | https://open.cherryin.net/v1 |
Organization ID | 可留空 |
填写完成后,点击测试并保存。
为什么是 OpenAI?
Dify 官方文档里说明 OpenAI 供应商支持填写自定义 Base URL,因此可以用来接入 CherryIN 这类 OpenAI 兼容接口。
选择或添加模型
保存凭据后,选择你要使用的模型。
如果默认列表里没有你想要的模型,可以尝试手动添加自定义模型,并填写完整模型 ID,例如:
anthropic/claude-sonnet-4.5anthropic/claude-opus-4google/gemini-2.5-flash
在应用或工作流中使用
创建一个 Chatbot、Workflow 或 Agent,然后在模型选择器中选中刚刚配置好的模型。
建议先做一个最简单的测试:
请用一句话介绍 CherryIN。如果应用能正常回复,说明接入已经完成。
推荐用法
- 聊天助手:优先使用
anthropic/claude-sonnet-4.5 - 复杂分析:可以测试
anthropic/claude-opus-4 - 低成本高频调用:可以先试
google/gemini-2.5-flash
常见问题
测试凭据时报错
优先检查这三项:
API Key是否正确Custom Base URL是否写成https://open.cherryin.net/v1- 账户余额和 Key 状态是否正常
模型列表里没有我要的模型
这是 Dify 中比较常见的情况。优先尝试:
- 手动添加自定义模型
- 使用完整模型 ID
- 先用一个已确认可用的模型进行连通性验证
我不是管理员,为什么看不到模型供应商设置?
这是 Dify 的权限限制,需要让工作区管理员或所有者帮你配置。
下一步
- 先了解通用规则:看 OpenAI 兼容接入指南
- 想做自动化流程:看 n8n 配置教程
CherryIN