首页 → 指南 → Chatbox 接入自定义 API：主机、路径、Claude 与生图

Chatbox 接入自定义 API：主机、路径、Claude 与生图

Chatbox 接自定义 API 有三处容易出错：API 主机和 API 路径的搭配；Claude 模式要带 /v1，而 Claude Code 偏偏不能带；还有图片生成器，它完全不认自定义提供方。我们读了 Chatbox 1.23.5 的源码，把每种填法都在我们的网关上实测了一遍，并整理了真实 Chatbox 用户遇到的报错。

添加提供方

1. 打开 设置 → 模型提供方，点 添加自定义提供商。起个名字，API 模式 选 OpenAI API 兼容。
2. API 主机 填 https://apiclan.us，API 路径 留空。
3. 粘贴控制台里的 API 密钥。
4. 点 获取 拉取密钥所在分组的模型，再点 检查 确认密钥可用。

API 主机	API 路径	Chatbox 实际请求
https://apiclan.us	（留空）	/v1/chat/completions ✓
https://apiclan.us/v1	/chat/completions	/v1/chat/completions ✓
https://apiclan.us	/chat/completions	/chat/completions ✗ 404

只有 API 路径 为空时，Chatbox 才会给主机补上 /v1。一旦填了路径，主机就原样使用——所以 https://apiclan.us 配 /chat/completions 会漏掉 /v1，返回一个正文为空的 404。要么路径留空，要么把 /v1 写进主机。

接入 Claude

有两种方式，地址规则不一样：

API 模式	API 主机	Chatbox 实际请求
OpenAI API 兼容	https://apiclan.us	/v1/chat/completions ✓
Claude API 兼容	https://apiclan.us/v1	/v1/messages ✓
Claude API 兼容	https://apiclan.us	/messages ✗ 404

最简单的是再加一个 OpenAI API 兼容 模式的自定义提供方，填 Claude 分组的密钥——我们记录到的 43 次 Chatbox 调用里，有 29 次是用这种方式调 claude-fable-5-1。如果想用 Claude API 兼容 模式，主机必须以 /v1 结尾，因为 Chatbox 只会在后面补 /messages。这和 Claude Code 正好相反：ANTHROPIC_BASE_URL 不能 带 /v1。

在 Chatbox 里生成图片

图片生成器 只列出内置的 OpenAI 提供方（以及 Chatbox 自家和 Gemini）。自定义提供方在代码里写死了没有图片模型，选它会报 Provider doesnt support image generation。

1. 打开 设置 → 模型提供方 → OpenAI（内置的那个，不是你加的自定义提供方）。
2. API 主机 填 https://api.apiclan.us，密钥用在 生图分组 里创建的那把。
3. 添加模型 gpt-image-2.5，模型类型 选 图片。
4. 打开 图片生成器，选 gpt-image-2.5。

聊天模型继续放在自定义提供方里：一把密钥只属于一个分组，内置 OpenAI 提供方里那把生图密钥跑不了 GPT 聊天模型。这里用 api.apiclan.us，是因为大图可能要好几分钟，而主地址超过 100 秒就会断开。我们按 Chatbox 的请求格式实测，一张 1024×1024 的图用了 21 秒。

真实 Chatbox 调用花了多少

截至 2026 年 10 月 12 日的 30 天里，我们网关上全部 43 次 Chatbox 调用，都是经 /v1/chat/completions 的流式请求：

模型	调用次数	首字中位数	平均每条消息
claude-fable-5-1	29	5.2 s	$0.039
gpt-6-astra	8	1.4 s	$0.006
gpt-5.6-sol	6	7.6 s	$0.004

这里 Claude 一条回复的花费约是 GPT 的 7 倍，主要因为回答更长（平均 622 个输出 token）。Chatbox 每一轮都会把整段对话重新发一遍，但在 Claude 上平均每次有 4,071 个 token 按缓存读取计费，而不是按全价输入，长对话因此不会贵得离谱。gpt-5.6-sol 最便宜，但出首字最慢，因为它要先推理再回答。

真实 Chatbox 用户遇到的报错

• 404 且正文为空 → 填了 API 路径但主机里没有 /v1，或者 Claude API 兼容 模式没带 /v1。对照上面两张表。
• 400 This model is not supported on the Chat Completions endpoint → 把 gpt-image-2.5 当聊天模型用了。图片模型只能在 图片生成器 里用。
• 403 Image generation is not enabled for this group → OpenAI 提供方里的密钥不是生图分组的。
• 404 model_not_found (is not supported by any configured account in this group) → 这个模型不在你密钥的分组里（有用户手打了 gpt-5.2-pro，我们没有这个模型）。用 获取 拉列表，别手打名字。
• Provider doesnt support image generation → 图片生成器选的是自定义提供方。改用内置的 OpenAI 提供方。

其他桌面客户端： Cherry Studio 接入自定义 API · Claude Code 的 base URL.

开始使用

无订阅、无最低消费、不用跟销售通话。用 USDT 充值，用多少花多少 —— 1 USDT = 2 额度。

看 30 秒快速开始

语言: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

本页价格由实时计费数据自动填入；第三方条款引自对方公开文档。