xujfcn commited on
Commit
80ad408
·
1 Parent(s): 841c605

客户端配置指南 - ChatBox/Cherry Studio/NextChat/LobeChat/Open WebUI/Dify

Browse files
Files changed (1) hide show
  1. README.md +288 -3
README.md CHANGED
@@ -1,3 +1,288 @@
1
- ---
2
- license: mit
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ tags:
4
+ - tutorial
5
+ - crazyrouter
6
+ - chatbox
7
+ - cherry-studio
8
+ - nextchat
9
+ - lobechat
10
+ - chatgpt
11
+ - ai-client
12
+ - llm
13
+ language:
14
+ - en
15
+ - zh
16
+ ---
17
+
18
+ # 💬 Crazyrouter 客户端配置指南
19
+
20
+ > 一个 API Key,在所有主流 AI 客户端中使用 624+ 模型
21
+
22
+ [Crazyrouter](https://crazyrouter.com) 完全兼容 OpenAI API,因此所有支持自定义 OpenAI 端点的客户端都可以直接使用。
23
+
24
+ ## 通用配置信息
25
+
26
+ 所有客户端的配置都用这三个值:
27
+
28
+ | 配置项 | 值 |
29
+ |--------|-----|
30
+ | API Base URL | `https://crazyrouter.com/v1` |
31
+ | API Key | `sk-your-crazyrouter-key`(在 [crazyrouter.com](https://crazyrouter.com) 获取) |
32
+ | 模型 | `gpt-4o`、`claude-sonnet-4-20250514`、`deepseek-chat` 等 |
33
+
34
+ ---
35
+
36
+ ## ChatBox
37
+
38
+ [ChatBox](https://chatboxai.app/) 是一款跨平台 AI 桌面客户端,支持 Windows、macOS、Linux、iOS、Android。
39
+
40
+ ### 配置步骤
41
+
42
+ 1. 打开 ChatBox → 设置(Settings)
43
+ 2. 选择 **AI Provider** → **OpenAI API Compatible**
44
+ 3. 填写:
45
+ - **API Host**: `https://crazyrouter.com`
46
+ - **API Path**: `/v1/chat/completions`
47
+ - **API Key**: `sk-your-crazyrouter-key`
48
+ - **Model**: 输入模型名称,如 `gpt-4o`
49
+ 4. 点击 **Save**
50
+
51
+ ### 多模型切换
52
+
53
+ 在 ChatBox 中可以创建多个 AI Provider 配置:
54
+ - 配置 1:`gpt-4o`(通用对话)
55
+ - 配置 2:`claude-sonnet-4-20250514`(编程分析)
56
+ - 配置 3:`deepseek-chat`(省钱日常)
57
+
58
+ 在对话中随时切换。
59
+
60
+ ---
61
+
62
+ ## Cherry Studio
63
+
64
+ [Cherry Studio](https://cherry-ai.com/) 是一款功能丰富的 AI 客户端,支持多模型对话、知识库、AI 绘画。
65
+
66
+ ### 配置步骤
67
+
68
+ 1. 打开 Cherry Studio → 设置 → 模型服务商
69
+ 2. 点击 **添加服务商** → 选择 **OpenAI**
70
+ 3. 填写:
71
+ - **名称**: `Crazyrouter`
72
+ - **API 地址**: `https://crazyrouter.com/v1`
73
+ - **API 密钥**: `sk-your-crazyrouter-key`
74
+ 4. 点击 **获取模型列表**(自动拉取 624+ 模型)
75
+ 5. 选择需要的模型,保存
76
+
77
+ ### 特色功能
78
+
79
+ - 支持自动获取模型列表
80
+ - 多模型同时对话对比
81
+ - 内置知识库 RAG
82
+ - 支持 DALL-E 绘画(通过 Crazyrouter)
83
+
84
+ ---
85
+
86
+ ## NextChat (ChatGPT Next Web)
87
+
88
+ [NextChat](https://github.com/ChatGPTNextWeb/ChatGPT-Next-Web) 是最流行的开源 ChatGPT 网页客户端。
89
+
90
+ ### 本地部署
91
+
92
+ ```bash
93
+ docker run -d -p 3000:3000 \
94
+ -e OPENAI_API_KEY="sk-your-crazyrouter-key" \
95
+ -e BASE_URL="https://crazyrouter.com" \
96
+ yidadaa/chatgpt-next-web
97
+ ```
98
+
99
+ ### Vercel 一键部署
100
+
101
+ 1. Fork [NextChat 仓库](https://github.com/ChatGPTNextWeb/ChatGPT-Next-Web)
102
+ 2. 在 Vercel 导入项目
103
+ 3. 设置环境变量:
104
+ - `OPENAI_API_KEY` = `sk-your-crazyrouter-key`
105
+ - `BASE_URL` = `https://crazyrouter.com`
106
+ - `CUSTOM_MODELS` = `+gpt-4o,+claude-sonnet-4-20250514,+deepseek-chat,+gemini-2.0-flash`
107
+ 4. 部署
108
+
109
+ ### 网页端设置
110
+
111
+ 如果已部署,在设置页面:
112
+ - **接口地址**: `https://crazyrouter.com`
113
+ - **API Key**: `sk-your-crazyrouter-key`
114
+ - **自定义模型名**: 添加需要的模型
115
+
116
+ ---
117
+
118
+ ## LobeChat
119
+
120
+ [LobeChat](https://github.com/lobehub/lobe-chat) 是一款现代化的开源 AI 聊天框架。
121
+
122
+ ### Docker 部署
123
+
124
+ ```bash
125
+ docker run -d -p 3210:3210 \
126
+ -e OPENAI_API_KEY="sk-your-crazyrouter-key" \
127
+ -e OPENAI_PROXY_URL="https://crazyrouter.com/v1" \
128
+ lobehub/lobe-chat
129
+ ```
130
+
131
+ ### 网页端设置
132
+
133
+ 1. 打开 LobeChat → 设置 → 语言模型
134
+ 2. 找到 **OpenAI** 配置
135
+ 3. 填写:
136
+ - **API Key**: `sk-your-crazyrouter-key`
137
+ - **API 代理地址**: `https://crazyrouter.com/v1`
138
+ 4. 开启 **自定义模型名称**,添加模型
139
+
140
+ ### 添加其他模型
141
+
142
+ LobeChat 支持多个 Provider,你可以把 Crazyrouter 配置为 OpenAI Provider,然后在模型列表中添加所有需要的模型名。
143
+
144
+ ---
145
+
146
+ ## Open WebUI
147
+
148
+ [Open WebUI](https://github.com/open-webui/open-webui) 是一款类 ChatGPT 的开源 Web UI。
149
+
150
+ ### Docker 部署
151
+
152
+ ```bash
153
+ docker run -d -p 8080:8080 \
154
+ -e OPENAI_API_BASE_URL="https://crazyrouter.com/v1" \
155
+ -e OPENAI_API_KEY="sk-your-crazyrouter-key" \
156
+ ghcr.io/open-webui/open-webui:main
157
+ ```
158
+
159
+ ### 网页端设置
160
+
161
+ 1. 登录 Open WebUI → 管理面板 → 设置 → 连接
162
+ 2. 添加 OpenAI API 连接:
163
+ - **URL**: `https://crazyrouter.com/v1`
164
+ - **Key**: `sk-your-crazyrouter-key`
165
+ 3. 保存后自动拉取模型列表
166
+
167
+ ---
168
+
169
+ ## BotGem (原 AMA)
170
+
171
+ [BotGem](https://botgem.com/) 支持 macOS、iOS、Android、Windows。
172
+
173
+ ### 配置步骤
174
+
175
+ 1. 打开 BotGem → 设置 → 服务商
176
+ 2. 选择 **OpenAI Compatible**
177
+ 3. 填写:
178
+ - **Endpoint**: `https://crazyrouter.com/v1`
179
+ - **API Key**: `sk-your-crazyrouter-key`
180
+ - **Model**: `gpt-4o`
181
+ 4. 保存
182
+
183
+ ---
184
+
185
+ ## Chatwise
186
+
187
+ [Chatwise](https://chatwise.app/) 是一款简洁的 macOS/iOS AI 客户端。
188
+
189
+ ### 配置步骤
190
+
191
+ 1. 设置 → 模型 → 添加自定义模型
192
+ 2. 选择 **OpenAI Compatible**
193
+ 3. 填写 API URL 和 Key
194
+ 4. 手动输入模型名称
195
+
196
+ ---
197
+
198
+ ## LibreChat
199
+
200
+ [LibreChat](https://github.com/danny-avila/LibreChat) 是一款功能强大的开源 AI 聊天平台。
201
+
202
+ ### Docker 部署
203
+
204
+ 在 `.env` 文件中配置:
205
+
206
+ ```env
207
+ OPENAI_API_KEY=sk-your-crazyrouter-key
208
+ OPENAI_REVERSE_PROXY=https://crazyrouter.com/v1/chat/completions
209
+ ```
210
+
211
+ 在 `librechat.yaml` 中添加自定义端点:
212
+
213
+ ```yaml
214
+ endpoints:
215
+ custom:
216
+ - name: "Crazyrouter"
217
+ apiKey: "${CRAZYROUTER_API_KEY}"
218
+ baseURL: "https://crazyrouter.com/v1"
219
+ models:
220
+ default: ["gpt-4o", "gpt-4o-mini", "claude-sonnet-4-20250514", "deepseek-chat", "gemini-2.0-flash"]
221
+ titleConvo: true
222
+ titleModel: "gpt-4o-mini"
223
+ ```
224
+
225
+ ---
226
+
227
+ ## Coze / 扣子
228
+
229
+ [Coze](https://www.coze.com/) 支持自定义模型接入。
230
+
231
+ ### 配置步骤
232
+
233
+ 1. 在 Coze 工作台 → 插件 → 自定义模型
234
+ 2. 选择 OpenAI 兼容格式
235
+ 3. 填写 Crazyrouter 的 API 地址和 Key
236
+ 4. 选择模型
237
+
238
+ ---
239
+
240
+ ## Dify
241
+
242
+ [Dify](https://dify.ai/) 是一款开源的 LLM 应用开发平台。
243
+
244
+ ### 配置步骤
245
+
246
+ 1. 设置 → 模型供应商 → 添加 **OpenAI-API-compatible**
247
+ 2. 填写:
248
+ - **模型名称**: `gpt-4o`(或其他模型)
249
+ - **API Key**: `sk-your-crazyrouter-key`
250
+ - **API endpoint URL**: `https://crazyrouter.com/v1`
251
+ 3. 保存并测试
252
+
253
+ 可以添加多个模型,在不同的应用中使用不同的模型。
254
+
255
+ ---
256
+
257
+ ## 通用技巧
258
+
259
+ ### 环境变量方式
260
+
261
+ 很多客户端支持环境变量,统一设置后所有客户端自动生效:
262
+
263
+ ```bash
264
+ export OPENAI_API_KEY="sk-your-crazyrouter-key"
265
+ export OPENAI_API_BASE="https://crazyrouter.com/v1"
266
+ ```
267
+
268
+ ### 模型推荐
269
+
270
+ | 场景 | 推荐模型 | 原因 |
271
+ |------|----------|------|
272
+ | 日常对话 | `gpt-4o-mini` | 快速、便宜 |
273
+ | 深度分析 | `gpt-4o` / `claude-sonnet-4-20250514` | 最强推理 |
274
+ | 编程辅助 | `deepseek-chat` / `claude-sonnet-4-20250514` | 代码能力强 |
275
+ | 长文档 | `gemini-2.0-flash` | 100万 token 上下文 |
276
+ | 数学推理 | `deepseek-reasoner` / `o3-mini` | 链式推理 |
277
+ | 省钱 | `deepseek-chat` | $0.14/百万 token |
278
+
279
+ ---
280
+
281
+ ## 链接
282
+
283
+ - 🌐 [Crazyrouter](https://crazyrouter.com) — 获取 API Key
284
+ - 🤖 [在线 Demo](https://huggingface.co/spaces/xujfcn/Crazyrouter-Demo)
285
+ - 💰 [价格对比](https://huggingface.co/spaces/xujfcn/Crazyrouter-Pricing)
286
+ - 📖 [快速入门](https://huggingface.co/xujfcn/Crazyrouter-Getting-Started)
287
+ - 💬 [Telegram 社区](https://t.me/crazyrouter)
288
+ - 🐦 [Twitter @metaviiii](https://twitter.com/metaviiii)