FancyHelper OpenAI 兼容端点配置指南
本文指导如何配置 FancyHelper 使用 OpenAI 兼容 API。首先在 config.yml 中将 provider 切换为 openai，并填写 api_url、api_key 和 model。文中列出了 DeepSeek、阿里云等主流平台的 Key 获取方式。配置完成后保存文件并重载插件即可验证。若遇报错，请检查拼写、密钥完整性及网络连接。
本文档教你从零开始配置 FancyHelper 使用 OpenAI 兼容 API。
1. 基本概念
FancyHelper 支持两种 AI 后端：
Cloudflare（默认）：开箱即用，不需要额外注册
OpenAI 兼容：可以接入任何兼容 OpenAI Chat Completions API 的服务，包括：
国内厂商：DeepSeek、通义千问（阿里云）、Kimi（月之暗面）、智谱 GLM
聚合平台：SiliconFlow、OpenRouter
本地部署：Ollama、vLLM
本文只讲 OpenAI 兼容模式。
如果你需要配置 Cloudflare Workers AI，请参阅 为FancyHelper创建Cloudflare的AI访问密钥
2. 配置文件在哪
配置文件是插件目录下的 config.yml：
plugins/FancyHelper/config.yml如果你是新手：把
config.yml当成一张"设置表"，用记事本或任意文本编辑器打开就能改。
3. 切换提供商
第一步：打开 config.yml，找到第 64 行附近：
# 提供商选择（接受参数：cloudflare/openai）
provider: cloudflare第二步：把 cloudflare 改成 openai：
provider: openai4. 填写 API 地址和密钥
改完 provider 后，往下翻几行，找到 openai 配置段（大约第 83 行）：
openai:
api_url: https://api.deepseek.com/chat/completions
api_key: your-openai-api-key
model: deepseek-v4-pro这三项的含义：
配置项 | 作用 | 从哪里来 |
|---|---|---|
| API 接口地址 | 各平台官方文档（参考下方表格） |
| 你的密钥 | 各平台后台创建 |
| 模型名称 | 各平台文档中给出的模型 ID |
⚠️ 第一次配置时：只改
api_key一项就能跑通。默认的 DeepSeek 配置可以直接用，去 DeepSeek 开放平台 注册拿 key 填进去就行。
5. 填写模型名称
模型名不是随便写的，要去各平台文档查。下面是示例：
平台 | 模型 | 正确的 model 值 |
|---|---|---|
DeepSeek | V4（旗舰推理） |
|
DeepSeek | V4（轻量快速） |
|
Kimi | K2.6 |
|
通义千问 | 旗舰 |
|
OpenAI | GPT-4o |
|
注意：
model必须跟各平台文档一字不差，大小写和斜杠都不能错。填错了会报 "model not found"。
6. 各平台获取 API Key 指南
DeepSeek（推荐新手首选）
注册账号并登录
点击左侧 "API Keys" → "创建 API Key"
复制以
sk-开头的密钥填入
config.yml的api_key字段
Endpoint：https://api.deepseek.com/chat/completions
新用户有免费额度，够用很久。
阿里云通义千问（Bailian / DashScope）
打开 阿里云百炼控制台
开通「百炼」服务（首次需要）
进入「API-KEY 管理」→ 创建 API Key
填入配置
Endpoint：https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
注意：阿里云的 endpoint 比较特殊，FancyHelper 会自动处理，你直接填上面这个就行。
Kimi（月之暗面）
注册登录后，进入「API Key」页面创建密钥
填入配置
Endpoint：https://api.moonshot.cn/v1/chat/completions
智谱 GLM
打开 智谱开放平台
注册登录 → 「API 密钥」→ 创建 API Key
填入配置
Endpoint：https://open.bigmodel.cn/api/paas/v4/chat/completions
SiliconFlow（聚合平台）
SiliconFlow 聚合了大量开源模型，一个 key 可以调用上百种模型。
打开 SiliconFlow → 注册登录
进入「API Key」页面创建密钥
模型名需要带前缀，如
deepseek-ai/DeepSeek-V3
Endpoint：https://api.siliconflow.cn/v1/chat/completions
OpenAI
进入 API Keys 页面 → Create new secret key
复制以
sk-开头的密钥国内用户需要代理，可以在
api_url里填代理地址
Endpoint：https://api.openai.com/v1/chat/completions
7. 验证配置是否生效
配置完成后：
保存
config.yml在 Minecraft 服务器后台执行
/fancyhelper reload重载配置在游戏里输入
/ai hello或进入 CLI 模式聊天
如果 AI 正常回复，说明配置成功了。
8. 完整配置示例
以下是一份改好了的 config.yml（只展示改动的部分）：
# 先把默认的 cloudflare 改成 openai
provider: openai
# 然后往下翻，修改 openai 段
openai:
# 以 DeepSeek 为例
api_url: https://api.deepseek.com/chat/completions
api_key: sk-your-deepseek-api-key-here
model: deepseek-v4-pro
# 副模型（用于压缩等轻量任务，可以跟主模型不同）
co-model: deepseek-v4-flash其他配置项（settings、sounds、notice 等）保持默认不动。
9. 常见问题
Q: 重载配置后，聊天还是没反应？
检查三个地方：
provider: openai拼写是否正确（区分大小写）api_key是否粘贴完整，前后不要有空格YAML 格式是否正确（冒号后面要有空格）
改完后执行 /fancyhelper reload，看控制台有没有报错。
Q: 报错 "401" 或 "API-key 不正确"
API Key 填错了，或者 Key 已经过期/被删除。回到平台重新创建一个。
Q: 报错 "404" 或 "model not found"
model 名称填错了。去平台文档确认模型 ID 的准确写法。
Q: 报错 "超时"（timeout）
两种可能：
网络不通（国内连 OpenAI 需要代理）
模型响应慢（推理模型可能几十秒才回复）
在 settings 段里调大 api_timeout_seconds：
settings:
api_timeout_seconds: 180Q: 国内访问外网服务很慢怎么办？
可以用国内服务商（DeepSeek、通义千问、Kimi、智谱），也可以自建代理。如果 api_url 填写了代理地址，所有请求都会走代理转发。