跳到导航
集成对话客户端

在 ChatBox 中使用 BeatAPI

在 ChatBox 中使用 BeatAPI

ChatBox 是一个跨平台桌面对话客户端。BeatAPI 同时提供 OpenAI、Anthropic、Gemini 三种请求格式，所以 ChatBox 的三种服务商类型都能用，选哪个取决于你想调的模型。

准备工作

  1. 已安装 ChatBox —— Windows、macOS、Linux 或网页版。
  2. 一把 BeatAPI 密钥 —— 在控制台 → API 密钥创建。

第一步：打开配置

首次启动会出现配置向导，点 Use your own API Key or local model。

已经配过的话，点左下角齿轮图标，或按 Ctrl+,（macOS 为 Cmd+,）。

第二步：选类型并填地址

地址随服务商类型而不同，因为每种客户端拼接的路径不一样。这一步填错是最常见的失败原因。

服务商类型API 地址用于
OpenAI APIhttps://api.beatapi.ioGPT、DeepSeek、GLM、Kimi、MiniMax、Qwen、MiMo、混元
Claude APIhttps://api.beatapi.io/v1Claude 系列
Gemini APIhttps://api.beatapi.io/Gemini 系列

三种情况下密钥都是同一把 BeatAPI 密钥。

账户下每个模型都支持全部四种格式，所以服务商类型决定的是 ChatBox 发出什么结构的请求，而不是你能调哪些模型。三个地址之所以不同，是因为 OpenAI 类型会拼 /v1/chat/completions、Claude 类型会拼 /messages、Gemini 类型会拼 v1beta/models/...。上表每一组拼出来都正好是一个真实存在的 BeatAPI 端点。

第三步：选模型

在下拉列表里选择模型；列表没刷新出来的话直接输入编号。

模型编号服务商类型适用场景
gpt-6-astraOpenAI API最新一代 GPT
gpt-5.6-terraOpenAI API日常对话，能力与成本均衡
claude-fable-5-1Claude API最新一代 Claude
claude-haiku-4-5-20251001Claude API快速便宜
gemini-3.7-flashGemini API快速、多模态
deepseek-v4-pro-0813OpenAI API低价强推理
glm-5.3-flashOpenAI API最便宜的档位，适合高频对话

完整目录见文本 API 各页与价目页。

可选参数

参数作用建议值
Temperature输出随机性0.7 偏创意 / 0.3 偏精确
Max Tokens输出长度上限2000–4000
Top P核采样0.9

设置 Max Tokens 是最简单的成本控制手段 —— 多数对话里，输出才是贵的那一半。

常见问题

ChatBox 连不上

  1. 对照上面的表复查 API 地址 —— 三种类型的 /v1 处理方式不同。
  2. 在控制台 → API 密钥确认密钥仍然可用。

列表里看不到 BeatAPI 的模型

直接在模型输入框里手工输入编号。编号见价目页，区分大小写。

对话过程中报错

状态码含义处理
401missing_api_key 或 invalid_api_key：密钥缺失、错误、已过期、已停用或额度已用尽从控制台重新复制密钥
402insufficient_credits：余额为零或低于本次价格充值
404模型编号错了，或地址与服务商类型不匹配对照上面两张表检查
429超出请求频率上限稍等；额度随累计充值提升
500 / 503我方临时故障（internal_error、processing_*）保留 request_id，退避重试，见错误码

查看用量与消费

控制台按密钥展示调用次数、token 与费用，同样的数据也可从 GET /v1/usage 获取。

获取支持

在控制台提交工单，并附上失败响应里的 request_id。