CherryINCherryIN
New API 使用指南

Dify 配置教程

在 Dify 中接入 CherryIN 模型,用于聊天助手、工作流和应用编排

什么是 Dify?

Dify 是一个常见的 AI 应用编排平台,可以用来搭建聊天机器人、工作流、Agent 和 API 应用。

CherryIN 可以通过 Dify 的 OpenAI 模型提供商接入。

开始之前

请先确认:

  1. 你已经拿到 CherryIN API Key
  2. 你在 Dify 工作区中拥有管理员或所有者权限
  3. 你准备好了要使用的模型 ID,例如 anthropic/claude-sonnet-4.5

权限要求

Dify 官方文档说明,只有工作区管理员和所有者才能配置模型供应商。

配置步骤

进入模型供应商

在 Dify 工作区中进入:

Settings -> Model Providers

新版本 Dify 将模型供应商作为插件管理。如果你的工作区里还没有启用 OpenAI 供应商,请先安装或启用它。

配置 OpenAI 供应商

找到 OpenAI 供应商后,新增一组凭据,按下面填写:

字段填写内容
API Key你的 CherryIN Key
Custom Base URLhttps://open.cherryin.net/v1
Organization ID可留空

填写完成后,点击测试并保存。

为什么是 OpenAI?

Dify 官方文档里说明 OpenAI 供应商支持填写自定义 Base URL,因此可以用来接入 CherryIN 这类 OpenAI 兼容接口。

选择或添加模型

保存凭据后,选择你要使用的模型。

如果默认列表里没有你想要的模型,可以尝试手动添加自定义模型,并填写完整模型 ID,例如:

  • anthropic/claude-sonnet-4.5
  • anthropic/claude-opus-4
  • google/gemini-2.5-flash

在应用或工作流中使用

创建一个 Chatbot、Workflow 或 Agent,然后在模型选择器中选中刚刚配置好的模型。

建议先做一个最简单的测试:

请用一句话介绍 CherryIN。

如果应用能正常回复,说明接入已经完成。


推荐用法

  • 聊天助手:优先使用 anthropic/claude-sonnet-4.5
  • 复杂分析:可以测试 anthropic/claude-opus-4
  • 低成本高频调用:可以先试 google/gemini-2.5-flash

常见问题

测试凭据时报错

优先检查这三项:

  1. API Key 是否正确
  2. Custom Base URL 是否写成 https://open.cherryin.net/v1
  3. 账户余额和 Key 状态是否正常

模型列表里没有我要的模型

这是 Dify 中比较常见的情况。优先尝试:

  1. 手动添加自定义模型
  2. 使用完整模型 ID
  3. 先用一个已确认可用的模型进行连通性验证

我不是管理员,为什么看不到模型供应商设置?

这是 Dify 的权限限制,需要让工作区管理员或所有者帮你配置。

下一步