使用WaveSpeed LLM配置OpenCat、ChatBox和LobeChat:一个应用,290+个模型
逐步指南:在OpenCat、ChatBox和LobeChat中配置WaveSpeed LLM。精确说明Endpoint、API Key和Chat Protocol字段的填写内容,无需猜测。
每款聊天应用都会问你的三个字段
每一款现代桌面端/移动端 LLM 聊天应用——OpenCat、ChatBox、LobeChat、ChatGPT Next Web、Cherry Studio 以及数十款其他应用——在你添加自定义提供商时都会要求你填写相同的三个字段:
- Endpoint(有时称为”API Host”、“Base URL”或”Server URL”)
- API Key(有时称为”Secret Key”、“SK”或”Token”)
- Chat Protocol(有时称为”API Type”或”Compatible Mode”)
对大多数人来说,这三个空白字段正是配置卡住的地方。本指南将告诉你对于 OpenCat、ChatBox 和 LobeChat 这三款最流行的聊天应用,使用 WaveSpeed LLM 作为后端时,每个字段应该填写什么。
通用答案
无论你正在配置哪款聊天应用,WaveSpeed LLM 的答案始终如下:
| 字段 | 值 |
|---|---|
| Endpoint / Base URL | https://llm.wavespeed.ai/v1 |
| API Key | 你的 WaveSpeed API 密钥(从控制台获取) |
| Chat Protocol | OpenAI(Chat Completions) |
| Model ID | vendor/model——例如 anthropic/claude-opus-4.6 |
有了这四个值,你可以连接任何兼容 OpenAI 的客户端。下面我们将逐步介绍三款具体应用。
前提条件:获取你的 WaveSpeed API 密钥
- 前往 wavespeed.ai 并登录。
- 打开 Dashboard → API Keys。
- 创建一个新密钥,立即复制并妥善保存。
保持此页面开启——你需要将密钥粘贴到下面每款应用中。
OpenCat
OpenCat 是一款适用于 macOS 和 iOS 的流行原生聊天客户端。
- 打开 OpenCat → Settings → API Providers → Add Provider(或编辑现有的 OpenAI 提供商)。
- 填写:
- Name:WaveSpeed LLM(任意标签均可)
- API Host:
https://llm.wavespeed.ai/v1 - API Key:
YOUR_WAVESPEED_API_KEY - Protocol / Provider Type:OpenAI
- 保存。OpenCat 将列出可用模型——选择
anthropic/claude-opus-4.6或 WaveSpeed 目录中的任何其他模型。 - 如果 OpenCat 未自动列出模型,请手动添加,ID 为
anthropic/claude-opus-4.6。
提示:OpenCat 允许你创建使用不同模型的多个助手。将每个助手指向不同的 WaveSpeed 模型 ID,即可并排比较 Claude、GPT、Gemini。
ChatBox
ChatBox 是一款跨平台(Windows、macOS、Linux、移动端)聊天应用。
- 打开 ChatBox → Settings → Model。
- 设置:
- Model Provider:OpenAI API(或”Custom OpenAI”)
- API Key:
YOUR_WAVESPEED_API_KEY - API Host:
https://llm.wavespeed.ai/v1 - API Path:
/chat/completions(默认值,保持不变) - Model:
anthropic/claude-opus-4.6(如果列表中没有,请手动输入)
- 保存并开始新的对话。
ChatBox 会按提供商缓存其模型列表。如果模型未显示,请手动输入模型 ID——ChatBox 将直接使用它。
LobeChat
LobeChat 是一款功能齐全的开源聊天 UI,支持自部署或通过 lobehub.com 使用。
- 打开 LobeChat → Settings → Language Model → OpenAI。
- 切换 Enable。
- 填写:
- API Key:
YOUR_WAVESPEED_API_KEY - API Proxy Address(或 Base URL):
https://llm.wavespeed.ai/v1
- API Key:
- 在 Model List 下添加自定义模型:
- Model ID:
anthropic/claude-opus-4.6 - 显示名称:任意内容
- Model ID:
- 保存并在对话中选择新模型。
即使你通过 WaveSpeed 调用 Claude 或 Gemini,LobeChat 的 OpenAI 提供商也是正确的选择——客户端使用 OpenAI Chat Completions 协议,WaveSpeed 会透明地将请求路由到上游模型。
为什么”OpenAI”始终是正确的协议选择
一个常见的困惑:如果我通过 WaveSpeed 调用 Claude,是否应该选择”Anthropic”作为协议?
不。 请选择 OpenAI。
WaveSpeed LLM 通过 OpenAI Chat Completions 协议暴露所有模型——Claude、GPT、Gemini、Llama、Qwen、DeepSeek。模型 ID 中的 anthropic/ 前缀只是告诉 WaveSpeed 将请求路由到哪个上游模型。你的聊天应用只需要支持 OpenAI 协议即可。
这正是统一的 OpenAI 兼容网关的意义所在:你的工具无需了解其中的差异。
值得尝试的热门模型 ID
| 模型 ID | 说明 |
|---|---|
anthropic/claude-opus-4.6 | 支持 100 万上下文的 Claude |
anthropic/claude-sonnet-4.6 | 更快、更便宜的 Claude |
openai/gpt-5.2-pro | 顶级 OpenAI 推理模型 |
openai/gpt-5.2-chat | 均衡的 GPT |
google/gemini-3-flash-preview | 快速多模态 |
deepseek/deepseek-v4 | 最实惠的强力编程模型 |
meta-llama/llama-4-70b | 开放权重,稳定可靠 |
在 wavespeed.ai/llm 浏览完整目录。
故障排查
“Invalid API Key” / 401 Unauthorized 你粘贴了错误的密钥。请从 WaveSpeed 控制台精确复制密钥——不要有前后空格。
“Model not found” / 404
模型 ID 必须使用完整的 vendor/model 格式。如果你的客户端自动补全为省略前缀的形式(如 claude-opus-4.6),请手动修改。
应用尝试连接 api.openai.com
你忘记修改 Base URL / API Host 了。重新打开设置并确认其为 https://llm.wavespeed.ai/v1。
SSL / 证书错误
将你的聊天应用更新到最新版本。所有现代版本均支持与 llm.wavespeed.ai 的标准 TLS 连接。
一个密钥,多款应用
将同一个 WaveSpeed API 密钥添加到你使用的每一款聊天客户端。一个账户、一张账单、290+ 个模型随处可用。
获取你的 WaveSpeed API 密钥,几分钟内连接你最喜欢的聊天应用。
