打开 Chatbox，左下角进 设置 → 模型 → 添加自定义提供方 → 接口格式选 OpenAI 兼容（OpenAI Compatible）→ API 域名填 https://xyuapi.top/v1 → API 密钥填平台后台生成的 sk- 开头令牌 → 模型名点 + 手动新增，敲进 gemini-2.5-pro → 保存。
就三步：填地址、填 Key、选模型。下面每一节都是这三步的细节补充，卡在哪一步就跳到对应的小节看。小鱼API 是 AI API 接入平台，Chatbox 这边只认 OpenAI 兼容格式，所以整套配置没有额外插件要装。
https://xyuapi.top/v1这一栏不同版本叫法不一样，有的写「API 域名」，有的写「API Host」，有的写「Base URL」，填的是同一个东西。值就是 https://xyuapi.top/v1，一个字符都别多。
备用地址是 https://xyuai.cc/v1，主域名连不通的时候换它。这个备用域名下面同时带 /v1beta/，要用 Gemini 原生格式的客户端走它。两个地址在同一账号、同一把密钥下通用。
密钥要去小鱼API 的网站后台自己生成，它不是账号密码，也不是注册邮箱。生成出来形如 sk-xxxxxxxx，复制的时候注意前后别带上空格。
Chatbox 的密钥输入框不会帮你做去空格处理，多一个空格就是 401。粘完把光标放到行尾按一下退格，确认最后一个字符就是密钥本身，再保存。
模型名不是从下拉框里挑的，是在模型列表区域点 + 自己敲进去的。敲完必须和平台列表里的写法完全一致，包括大小写和连字符的位置。
gemini-2.5-pro 就写 gemini-2.5-pro，别自己加 -latest 后缀，别把中间的短横改成下划线。写错的结果是 model not found 或者 400 参数错误。
三种系统的安装包在项目发布页都能下到，装完打开就是主界面。配置存在本机的应用数据目录里，跟系统登录账号无关。
Windows 装完建快捷方式，macOS 拖进应用程序文件夹，Linux 用 AppImage 或者 deb 包都行。三端界面基本一致，设置项的层级也一样。
网页版打开就能用，但配置写在浏览器的本地存储里。换浏览器、清缓存、开无痕模式，之前配的提供方和密钥就全没了。
所以网页版适合先试一下手感。要长期用，先导出配置留个备份，或者干脆装桌面端。
安卓和 iOS 都有客户端，配置入口同样是应用里的设置页，跟手机的系统设置没关系。
移动端的输入框窄，长密钥粘贴时容易少字符。稳妥的做法是先在桌面端配好，导出配置文件再导进移动端。
路径是先进 设置，再进 模型，页面往下拉能看到「添加自定义提供方」。点进去是一组输入框：名称、接口格式、API 域名、API 密钥、模型列表。
名称随便写，写「小鱼API」方便自己认。它只是个标签，不参与调用。
这一项选错，后面全白搭。下拉框里有 OpenAI 兼容、OpenAI 原生、Anthropic、Gemini 这些选项，选 OpenAI 兼容（OpenAI Compatible）。
小鱼API 对外提供的就是 OpenAI 兼容格式，选这个直接能通。选成 Anthropic 之类的原生格式，请求体结构对不上，会报参数缺失。
表格里以 /v1 结尾的那种是标准答案，照着填就行。
| 写法 | 填在哪里 | 结果 |
|---|---|---|
https://xyuapi.top/v1 | API 域名栏 | 客户端自动补 /chat/completions，正常调用 |
https://xyuapi.top/v1/chat/completions | API 域名栏 | 会拼成重复路径，报 404 |
https://xyuai.cc/v1 | API 域名栏 | 备用地址，主域名不通时换它 |
全路径那种写法是给代码里直接发请求用的，填进客户端的地址栏反而出错。客户端会自己在地址后面接上接口路径，你多填一段它就多拼一段。
密钥框里只放 sk- 令牌本身。别加 Bearer 前缀，客户端发请求时会自己加上，你手动带上就变成两个前缀，服务端当成无效密钥。
多个提供方可以共用同一把令牌，也可以一个提供方配一把，方便按用途分开看用量。
在模型列表区域点 +，弹出的输入框里敲模型名，回车确认。填进去几个，模型选择器里就有几个可选项。
一次别塞太多，切换时容易点错。建议先加两个日常用的，其余用到再加。
填完之后，整个提供方的配置长这样，可以对着核一遍：
{
"provider": "小鱼API",
"api_host": "https://xyuapi.top/v1",
"api_key": "sk-替换成你自己的令牌",
"api_format": "OpenAI Compatible",
"models": ["gemini-2.5-pro", "deepseek-v3.2-thinking", "claude-opus-4-5-thinking"],
"temperature": 0.3,
"max_tokens": 4096,
"timeout": 300,
"proxy": "none"
}Chatbox 有「获取模型列表」这类按钮，点它其实是去请求 /v1/models 接口。小鱼API 支持这个接口，正常情况下能把模型名拉出来直接勾选。
拉不到也不影响使用。列表接口只是个便利功能，勾不出东西来，手填模型名照样能跑。所以按钮转圈或者报错，跳过它，手填就行。
点「测试连通性」或者「检查连接」，客户端会发一条很短的请求探路。报错分两类，处理方向完全不同。
一类是连接失败，提示网络错误或者超时，问题在地址写错或者代理在中间捣乱。另一类是连上了但被拒，返回 401 或者 model not found，问题在密钥或者模型名。
测试时发出去的模型名，就是你在列表里选中的那一个。所以先确认选中的模型名没写错，再点测试，不然白测。想绕开客户端排查，可以直接在终端打一条：
curl -s https://xyuapi.top/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model":"gemini-2.5-pro","messages":[{"role":"user","content":"hi"}],"stream":false}'终端能通、客户端报错，说明密钥和地址都没问题，去查客户端的代理和超时设置。
这个值决定每次请求带多少条历史消息过去。设成无限，聊到第五十轮的时候，请求体里塞着几十轮对话，token 一路涨上去，响应也跟着变慢。
日常聊天设 10 到 20 条就够。要针对长文档连续追问，临时调到 30 以上。入口在 设置 → 对话，或者会话右上角的参数面板。
温度管的是随机性。写代码、查事实、做翻译，设 0.2 到 0.3，同一个问题反复问，答案基本一致。
写文案、起标题、想点子，设 0.7 到 0.9，措辞会活一点。设成 0 也不是完全确定，只是把随机性压得很低。日常从 0.3 起步，觉得答得太死板再往上调。
这一项限制单次回复长度。设成 1024，稍长的回答会被截断在半句话上，thinking 类模型还要先花掉一部分额度做推理，更容易被切。
建议日常设 4096，需要长回答设 8192。它只是上限不是预扣，实际按生成量算。
系统提示词在 设置 → 对话 或者提供方的高级设置里，写一次之后，每个新会话都会自动带上。
写法上给具体约束比给身份设定管用。比如写「回答用中文，代码块标注语言，不确定的地方直接说不确定」，比写「你是一个专业助手」有效得多。
按次计费，发一次请求算一次，跟输入输出长度基本无关。带 thinking 的模型单次成本高，但推理质量也高，别拿它去做翻译和改错别字这类活。
日常翻译、改写、整理格式，交给便宜的那档。方案设计、复杂代码调试、长文档推理，再切到贵的那档。
| 模型名（照抄手填） | 按次价格 |
|---|---|
gemini-2.5-pro | 0.031 元/次 |
deepseek-v3.2-thinking | 0.049 元/次 |
grok-4.1 | 0.05 元/次 |
claude-sonnet-4-5-thinking | 0.09 元/次 |
claude-opus-4-5-thinking | 0.12 元/次 |
这五个名字直接复制粘贴到模型列表里，不要手敲，也不要改任何一个字符。
Chatbox 支持同时挂多个提供方。你可以把小鱼API 配成一个，本地的 Ollama 配成另一个，两边互不干扰，各自有各自的模型列表。
新会话的输入框上方或者右上角有模型选择器，点开就能切。切换只影响当前这个会话，已经聊着的会话不会跟着变。
在 Chatbox 里开一个新会话聊十轮，就是十次请求。用 deepseek-v3.2-thinking，十次大约 0.49 元。
同一天里用 gemini-2.5-pro 聊十轮是 0.31 元。碰到硬活塞给 claude-opus-4-5-thinking，十轮 1.2 元。按这个量级估月度开销就行。
要带。https://xyuapi.top/v1 是标准写法，/v1 不能省。
有人图省事写成 https://xyuapi.top/v1/v1，客户端在它后面又补一段接口路径，请求打到不存在的路径上，直接 404。看到 404 先回头看这里是不是重复了。
建议不带。末尾带斜杠的时候，有的客户端会拼出 //v1 这种双斜杠路径，服务端不认，表现同样是 404 或者 400。
统一写成 https://xyuapi.top/v1，末尾干干净净结束，省得排查。
客户端如果跟着系统代理走，请求会先发给本机的代理，再由代理转出去。代理不稳、规则不匹配、或者代理自己那套绕行规则和这个域名对不上，表现就是一直转圈然后超时。
设置里找代理选项，选「不使用代理」或者「直连」。改完把客户端完全退出再打开，让设置真正生效。
thinking 类模型要先推理再作答，一段复杂任务跑两三百秒很正常。客户端默认超时通常只有几十秒，到点直接断开，你看到的就是「请求超时」或者流式输出到一半停住。
到 设置 → 高级 或者提供方的高级设置里找超时项，调到 300 秒以上，写 600 也行。这个值不影响计费，只决定等多久算放弃。
| 提示 | 原因 | 怎么改 |
|---|---|---|
| 401 | 密钥写错、前后带空格、复制不全 | 重新生成并整段粘贴，确认以 sk- 结尾 |
| 403 | 密钥被限制或者权限不足 | 检查令牌状态和可用模型范围 |
| 404 | 地址写错，路径里出现重复的 /v1 | 改回 https://xyuapi.top/v1，末尾不留斜杠 |
| 429 | 请求太密，触发限流 | 降低并发，隔几秒再发一次 |
| model not found | 模型名和平台列表不一致 | 照平台原文重填，去掉自加的 -latest |
对着这张表看报错，五分钟内基本能定位到是哪一环出的问题。
一个是自己加后缀，把 gemini-2.5-pro 写成 gemini-2.5-pro-latest。另一个是大小写和连字符随手改，把 deepseek-v3.2-thinking 写成 deepseek-v3-2-thinking。
平台列表里怎么写，你就怎么填。复制粘贴永远比手敲可靠，尤其是带数字和连字符的名字。
设置里有导出配置，导出来是一个文件，里面包含提供方、密钥、模型列表和各项参数。换电脑时导入这个文件，之前配好的全部回来，不用重敲一遍。
导出的文件里带着明文密钥，别往外发，也别丢到公共群里。自己存网盘的话单独放一个目录。
移动端和桌面端各自存自己的配置，不会自动互通。想在手机上用桌面端这套自建配置，就把桌面端导出的文件传到手机，在移动端的设置里导入。
导入完检查一遍密钥末尾有没有少字符，窄屏粘贴容易漏。确认无误再用，省得后面报 401 又来回找原因。