沉浸式翻译与其他客户端
任何支持「自定义 OpenAI 兼容端点」的软件，都能接 FluxToken。通用三要素见下。
端点 + 令牌 + 模型名。 任何支持自定义 API 地址的客户端都是填这三样：
| 项 | 值 |
|---|---|
| 端点（OpenAI 兼容模式） | https://cn.fluxtoken.ai/v1 |
| 令牌 | 控制台创建的 sk-... |
| 模型名 | 从模型列表逐字照抄 |
末尾的 /v1 不能少，这是 OpenAI 兼容接口的要求。
一、沉浸式翻译
沉浸式翻译这类浏览器扩展/软件的接入方式，是在设置里添加自定义翻译服务或 自定义 OpenAI 兼容接口，填入端点、密钥和模型。
| 填什么 | 值 |
|---|---|
| 接口地址 / Base URL | https://cn.fluxtoken.ai/v1 |
| API Key | 你的 sk- 令牌 |
| 模型 | 见下面的选择建议 |
沉浸式翻译是第三方产品
沉浸式翻译由第三方维护，与 FluxToken 没有隶属关系。 它的版本、界面和设置项由它的维护者决定，以沉浸式翻译官方文档为准。
本文档不写死它的皮肤、按钮名称和版本号——界面会随版本变化。
翻译场景该选哪个分组
翻译是高频、短请求、可容忍轻微波动的负载，和编码 agent 的需求完全不同：
| 你的取舍 | 分组 | 理由 |
|---|---|---|
| 便宜优先（推荐） | 【Codex】Plus · 轻享 | 说明是「价格友好」，翻译单条请求短，排队影响有限 |
| 便宜优先（更极端） | 【Codex】反代 · 福利 | 全站最低价；说明写明不稳定时换组 |
| 稳定优先 | 【Codex】Pro · 稳享 | 稳定优先线路 |
| Gemini 系 | 【Gemini】Pro · 企业级 | 企业级池子 |
| Kimi | 【Kimi】稳定 · 福利 | Kimi 专用 |
便宜档的波动是写在说明里的
【Codex】反代 · 福利 的说明是「反代池 · 纯福利，不稳定时切换其他分组」， 【Codex】Plus · 轻享 是「可用性随渠道波动」。
翻译的关键是批量、快速、便宜，偶发失败重试即可，所以适合放便宜档。 但如果你是在给客户做实时翻译，就换到稳享档，别拿福利档跑关键链路。
模型选择
翻译任务不需要旗舰模型，用便宜档位里的模型即可。可选的包括：
gpt-5.5、gpt-5.6、gpt-5.6-terra、gpt-6-sol、gpt-6.1-sol （以上在 Codex 分组里）、gemini-3.7-flash、gemini-3.8-flash（Gemini 分组）。
另外注意：只要分组选对了，模型名就必须在该分组的清单里。 Codex 的 8 个模型在 6 个 Codex 分组里完全一致，所以换 Codex 分组不用换模型名。
二、其他客户端通用做法
任何支持自定义 API 地址的软件，按这个顺序配：
- 在控制台建令牌，选好分组（通用准备）
- 在客户端里选「OpenAI 兼容」或「自定义 OpenAI」类选项
- 填 Base URL：
https://cn.fluxtoken.ai/v1 - 填 API Key：你的
sk-令牌 - 手动添加模型 ID（很多客户端不会自动拉取清单）
- 重启客户端，发一句话验证
客户端不自动列模型是常态
不少软件填完地址和密钥后，模型下拉框是空的。这不是配置错了—— 它们不主动请求 /v1/models，需要你手动把模型 ID 填进去。
模型 ID 从模型列表抄，注意点号和中划线的区别 （kimi-k2.7-code 里是点号，claude-sonnet-5-5 里是中划线）。
三、如果你的客户端只支持 Anthropic 兼容
有些客户端只提供 Anthropic 兼容（Claude）模式。这类客户端要填的是：
| 填什么 | 值 |
|---|---|
| Base URL | https://cn.fluxtoken.ai（不带 /v1） |
| API Key | 你的 sk- 令牌 |
规则正好相反：OpenAI 兼容要加 /v1，Anthropic 兼容不能加。 填反了的表现是 404。
四、连通性验证（所有客户端通用）
第一步：端点是否可达（期望 401）
curl -s -o /dev/null -w '%{http_code}' https://cn.fluxtoken.ai/v1/models; echo401 是正确结果：端点通，只是拒绝了没有凭证的请求。
第二步：令牌与分组是否正确（期望 200）
curl -s https://cn.fluxtoken.ai/v1/models -H "Authorization: Bearer sk-你的令牌"这份清单就是你这个令牌能用的全部模型。客户端里填的模型 ID 必须出自这份清单。
这两条命令能定位问题在哪一侧
- 两条都正常、客户端不行 → 客户端配置问题（端点路径、模型 ID、没重启）
- 第二步清单里没有你要的模型 → 分组选错了，去控制台改令牌分组
五、排查顺序
| 你看到的 | 先查这里 |
|---|---|
| 404 | Base URL 的 /v1 加错或漏加（按接口类型判断） |
| 401 | 令牌复制不全、带了引号空格 |
| 模型下拉框是空的 | 需要手动添加模型 ID |
| 连不上 / 超时 | 端点选择问题，国内加速异常可回退 全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。 |
模型不存在 | 分组不含该模型，或模型 ID 拼错 |
| 改了配置没反应 | 完全退出客户端进程再启动 |
六、关于第三方客户端
本页涉及的所有客户端（沉浸式翻译及其他）都是第三方产品，与 FluxToken 没有隶属关系：
- 文档只写「往哪个框里填什么」，不写死第三方工具的版本号和界面文案
- 工具本身的报错（装不上、找不到入口、功能不工作）先查该工具的上游文档
- FluxToken 这侧能保证的只有端点、令牌、模型名这三项
如果某个第三方工具的文档与本页冲突，以该工具官方文档为准。
相关页面
- 客户端接入总览 —— 按工具找页面
- 怎么选分组 —— 按用途选分组的推荐表
- Codex / GPT 分组 —— 便宜档的波动说明
- 模型列表 —— 全部模型 ID