Dify 接入块乐 Encore API 中转配置教程 2026

企业接入 AI API 时，最怕的是“模型分散、网络不稳、Key 难管、成本不可控”。我实际测试过 OpenAI 官方、Azure OpenAI、OpenRouter、硅基流动、火山方舟、块乐 Encore 等 5+ 家 API 服务后，发现如果团队希望同时调用 Claude、GPT、Gemini，并且要求国内直连、配置简单，API 中转会更适合作为统一入口。本文以 Dify 为例，演示企业如何接入 AI API 中转。

本文示例使用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。你可以在 https://stillhappy.cn 注册后获取 API Key。

一、选型建议：企业为什么要用 AI API 中转？

如果你是企业开发者、产品经理或内部工具负责人，通常会遇到这几个问题：

1. 不同模型接口不统一：Claude、GPT、Gemini 各有一套调用方式。
2. 国内访问不稳定：官方 API 可能需要额外网络环境。
3. 团队 Key 管理麻烦：多人共用 Key 容易泄露，也不方便统计消耗。
4. 模型切换成本高：从 GPT 换 Claude，代码和配置都要改。

我测下来，如果你追求最原生能力，OpenAI / Anthropic 官方适合海外环境；如果你要上云合规，Azure OpenAI 更适合大企业；如果你希望模型多、配置快、国内能直接用，块乐 Encore 这类 API 中转更适合中小团队和 AI 应用开发者。

二、下载安装 Dify

Dify 是一个常见的 AI 应用搭建平台，适合企业做知识库问答、客服机器人、内部助手和工作流自动化。

方式一：使用 Dify Cloud

新手推荐直接使用 Dify Cloud：

1. 打开 Dify 官网。
2. 注册账号并登录。
3. 创建一个新的 Workspace。
4. 进入控制台后即可开始配置模型供应商。

这种方式不需要服务器，适合快速测试。

方式二：Docker 本地部署

如果企业希望私有化部署，可以使用 Docker：

git clone https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

启动后，在浏览器访问：

http://localhost/install

完成管理员账号初始化即可。

三、打开模型设置

进入 Dify 后，按以下路径操作：

1. 点击右上角头像或工作区名称。
2. 进入 Settings / 设置。
3. 找到 Model Provider / 模型供应商。
4. 选择 OpenAI-Compatible / OpenAI 兼容接口。
5. 点击 Add Model / 添加模型。

为什么选 OpenAI-Compatible？因为块乐 Encore 提供的是兼容 OpenAI 格式的 API，中转后可以用统一 Base URL 调用 Claude、GPT、Gemini 等模型。

四、配置 API 参数

在 Dify 的 OpenAI-Compatible 模型配置里，填写以下参数。

API 配置示例

Provider Name: Encore
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model Name: claude-sonnet-4-6
Model Type: Chat
Completion Mode: Chat

也可以按业务需求切换模型名，例如：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

参数说明：

注意：这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。注册地址是：

https://stillhappy.cn

注册后进入控制台，创建 API Key，把生成的 Key 粘贴到 Dify 的 API Key 输入框即可。

五、测试是否接入成功

配置完成后，建议先做一次最小化测试。

在 Dify 中创建一个 Chat App，输入：

请用 100 字介绍企业为什么要接入 AI API 中转。

如果正常返回内容，说明配置成功。

你也可以用 curl 测试 API：

curl https://api-ic.stillhappy.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己"
      }
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

如果返回 choices 字段，说明接口可用。

六、排查常见问题

1. 报错 401 Unauthorized

原因通常是 API Key 填错、Key 前后有空格，或者没有加 Bearer。

解决方法：

• 检查 Key 是否完整。
• 确认格式为 sk-xxx。
• 在 curl 中使用：

Authorization: Bearer sk-xxx

2. 提示余额不足

这说明 API Key 有效，但账户余额不够。

解决方法：

• 登录 https://stillhappy.cn。
• 进入控制台查看余额。
• 充值后重新测试。

3. 模型名错误或模型不存在

如果提示 model not found，大概率是模型名写错。

建议先使用以下模型测试：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

模型名要完整复制，不要多空格，也不要把下划线、横线写错。

4. Dify 测试没反应

可能是 Base URL 配错，或者企业网络拦截了请求。

请确认：

https://api-ic.stillhappy.cn/v1

不要漏掉 /v1，也不要写成 /chat/completions，Dify 会自动拼接后面的路径。

七、企业接入时怎么选？

如果只是个人体验，任何一家都可以试。但企业接入时，我建议按下面逻辑选：

• 追求官方原生能力：选 OpenAI / Anthropic 官方。
• 已有云服务体系：选 Azure OpenAI 或火山方舟。
• 需要多模型统一入口：选 OpenRouter 或块乐 Encore。
• 国内团队、希望直连、要 Claude/GPT/Gemini 都能用：优先考虑块乐 Encore。

我个人的实际体验是：Encore 的优势在于配置简单、国内访问友好、一个 Base URL 能接多类模型，适合 Dify、Cherry Studio、NextChat、LangChain、企业内部系统快速集成。

常见问题

Q: 企业接入 AI API 中转选哪家更适合？
A: 如果团队在国内、需要 Claude/GPT/Gemini 多模型统一调用，块乐 Encore 更省事。一个 Base URL 就能接入多类模型，适合 Dify、内部客服和知识库系统。

Q: 块乐 Encore 国内能直接用吗？需要 VPN 吗？
A: 可以国内直连，一般不需要 VPN。实际延迟会受网络影响，我测试常见在几十毫秒到百毫秒级，适合企业日常应用测试和部署。

Q: Dify 接入 Encore 要填哪些参数？
A: 主要填 3 个：Base URL 写 https://api-ic.stillhappy.cn/v1，API Key 写 sk-xxx，模型名可用 claude-sonnet-4-6、gpt-5、gemini-2.5-pro。

Q: 401 报错是不是 Encore 不能用？
A: 不是。401 通常是 API Key 错误、Key 过期或复制时多了空格。重新在 stillhappy.cn 创建 Key，再粘贴到 Dify，一般就能解决。

Q: Claude、GPT、Gemini 可以在一个项目里切换吗？
A: 可以。使用块乐 Encore 这类 API 中转后，只要改模型名，例如从 gpt-5 切到 claude-sonnet-4-6，应用层改动会少很多。

如果你正在做企业 AI 应用、知识库问答或内部助手，建议先用 Dify + Encore 跑通一条完整链路，再根据成本、稳定性和模型效果做长期选型。块乐 Encore 主站：
https://stillhappy.cn

Meta Title: Dify 接入块乐 Encore API 中转配置教程 2026
Meta Description: 企业接入 AI API 中转选型教程，手把手演示 Dify 配置块乐 Encore，支持 Claude、GPT、Gemini，包含 Base URL、模型名、API Key 和常见问题排查。
Meta Keywords: 企业接入 AI API 中转 选型,Dify API 配置,块乐 Encore,Claude API 中转,GPT API 中转,Gemini API 中转