Chatbox 配置指南

Chatbox 配置指南

Chatbox 是一款支持多模型 API 的桌面聊天客户端

📋 目录

下载安装

智谱 GLM Coding Plan

配置信息

项目 值
名称 zhipu
API模式 OpenAI API兼容
API密钥 从 智谱控制台 获取
API主机 https://open.bigmodel.cn/api/coding/paas/v4
API路径 /chat/completions

可用模型

模型 说明
glm-5 最新模型 ⭐
glm-4.7 高性能
glm-4.7-flash 快速
glm-4.7-flashx 超快
glm-4 稳定版
glm-4-flash 经济版
glm-4-plus 增强版

配置步骤

  1. 打开 Chatbox → 设置 (⌘ + ,)
  2. 点击 添加提供商 → OpenAI 兼容
  3. 填写配置：
    名称: zhipu
API密钥: [你的智谱 API Key]
API主机: https://open.bigmodel.cn/api/coding/paas/v4
API路径: /chat/completions
  4. 点击 检查 验证
  5. 点击 获取 加载模型列表
  6. 选择模型 → 保存

MiniMax Coding Plan

配置信息

项目 值
名称 minimax-coding
API模式 OpenAI API兼容
API密钥 从 MiniMax 控制台 获取 Coding Plan Key
API主机 https://api.minimaxi.com/v1
API路径 /chat/completions

可用模型

模型 说明
MiniMax-M2.5 顶尖性能 ⭐
MiniMax-M2.5-highspeed 极速版
MiniMax-M2.1 强大编程能力
MiniMax-M2.1-highspeed 极速版
MiniMax-M2 高效编码

⚠️ 注意事项

  1. 需要 Coding Plan Key

  2. 不支持自动获取模型

    • 需要手动添加模型
    • 点击 新建 → 输入模型名称

配置步骤

  1. 打开 Chatbox → 设置 (⌘ + ,)
  2. 点击 添加提供商 → OpenAI 兼容
  3. 填写配置：
    名称: minimax-coding
API密钥: [你的 Coding Plan Key]
API主机: https://api.minimaxi.com/v1
API路径: /chat/completions
  4. 手动添加模型：
    • 点击 新建
    • 输入：MiniMax-M2.5
  5. 选择模型 → 保存

OpenRouter

配置信息

项目 值
名称 openrouter
API模式 OpenAI API兼容
API密钥 从 OpenRouter 获取
API主机 https://openrouter.ai/api/v1
API路径 /chat/completions

热门模型

模型 说明
anthropic/claude-3.5-sonnet Claude 3.5
openai/gpt-4o GPT-4o
openai/o1-preview o1 推理模型
google/gemini-2.0-flash-exp Gemini 2.0
deepseek/deepseek-chat DeepSeek
meta-llama/llama-3.3-70b-instruct Llama 3.3

配置步骤

  1. 打开 Chatbox → 设置 (⌘ + ,)
  2. 点击 添加提供商 → OpenAI 兼容
  3. 填写配置：
    名称: openrouter
API密钥: [你的 OpenRouter API Key]
API主机: https://openrouter.ai/api/v1
API路径: /chat/completions
  4. 点击 获取 加载模型列表
  5. 选择模型 → 保存

⚠️ 地区限制

部分模型在中国大陆不可用：

  • ❌ anthropic/claude-*
  • ❌ openai/o1-*
  • ⚠️ openai/gpt-4o（部分地区）

🔧 解决方案

方案 1：开启 VPN

  1. 开启 VPN
  2. 开启全局模式（不是规则模式）
  3. 开启系统代理

⚠️ 注意：只开 VPN 不开全局模式，Chatbox 可能不走代理

方案 2：Chatbox 配置代理

如果开了 VPN 还不行，在 Chatbox 中手动配置代理：

设置 → 代理
  类型: SOCKS5 或 HTTP
  地址: 127.0.0.1
  端口: [你的代理端口]

常见代理端口：

  • HTTP: 7890, 1087
  • SOCKS5: 7891, 1080

方案 3：TUN 模式

如果以上都不行：

  1. 在代理软件中开启 TUN 模式（增强模式）
  2. 重启 Chatbox

模型配置

新增模型

  1. 在提供商设置页面
  2. 点击 获取 按钮
  3. 从列表中选择模型
  4. 点击保存

手动添加模型

（适用于不支持自动获取的平台，如 MiniMax）

  1. 在模型区域点击 新建
  2. 输入模型名称（如 MiniMax-M2.5）
  3. 保存

模型设置

  1. 点击模型旁的 设置 按钮
  2. 选择模型能力：
    • 视觉（图片识别）
    • 函数调用
    • 流式输出
  3. 点击 测试 验证模型
  4. 保存设置

常见问题

1. 提示 "insufficient balance"

原因：API Key 类型错误或余额不足

解决方案：

  • 智谱：确认使用的是 Coding Plan 的 API Key
  • MiniMax：确认创建的是 Coding Plan Key，不是普通 Key

2. 提示 "This model is not available in your region"

原因：地区限制

解决方案：

  1. 开启代理的 全局模式 或 TUN 模式
  2. 在 Chatbox 中配置代理
  3. 重启 Chatbox

3. 无法获取模型列表

原因：平台不支持 /v1/models 端点

解决方案：手动添加模型

4. API 主机格式

平台 正确格式 错误格式
智谱 https://open.bigmodel.cn/api/coding/paas/v4 ~v4/v1
MiniMax https://api.minimaxi.com/v1 ~v1/v1
OpenRouter https://openrouter.ai/api/v1 ~v1/v1

注意：API 路径已经包含 /v1，不要再重复添加

相关链接

最后更新: 2026-03-15

posted @ 2026-03-15 22:10  pangzitudou  阅读(1)  评论(0)    收藏  举报