沉浸式翻译自定义 API 地址怎么填:四个字段的准确写法
翻译服务 → 添加自定义翻译服务 → 自定义 AI,四个字段这样填:
| 字段 | 填什么 | 常见错误 |
|---|---|---|
| 名称 | 随便写,如 glm |
无 |
| 接口地址 | 完整请求路径,结尾是 /chat/completions |
只写到 /v1,报 404 |
| API Key | 服务商控制台生成的密钥 | 复制时带空格、带了换行 |
| 模型 | 服务商文档里的完整模型 ID | 自己加空格、改大小写、漏组织前缀 |
填完点右上角「测试」,出现绿色对勾再回页面用。测试不通过就是这四项之一,不用怀疑网络。
为什么地址要写到 /chat/completions
Section titled “为什么地址要写到 /chat/completions”OpenAI 那套接口里,https://api.xxx.com/v1 只是「版本前缀」,真正的请求路径是它后面的 /chat/completions。
有些客户端(比如 OpenAI 官方 SDK)会自动拼上后半段,所以只填 base URL 也能用;
沉浸式翻译不拼,你填什么它就请求什么。
所以:
- ✅
https://api.siliconflow.cn/v1/chat/completions - ❌
https://api.siliconflow.cn/v1→ 404 - ❌
https://api.siliconflow.cn→ 404 - ❌
https://api.siliconflow.cn/v1/chat/completions/→ 有的服务端会因为末尾斜杠 301 到 GET,报方法不允许
各服务商的完整地址
Section titled “各服务商的完整地址”| 服务商 | 接口地址 | 模型名示例 |
|---|---|---|
| 智谱 | https://open.bigmodel.cn/api/paas/v4/chat/completions |
glm-4.7-flash |
| 硅基流动 | https://api.siliconflow.cn/v1/chat/completions |
Qwen/Qwen2.5-7B-Instruct |
| 阿里云百炼 | https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions |
qwen-plus |
| DeepSeek | https://api.deepseek.com/v1/chat/completions |
deepseek-chat |
| 月之暗面 | https://api.moonshot.cn/v1/chat/completions |
moonshot-v1-8k |
| OpenAI | https://api.openai.com/v1/chat/completions |
gpt-4o-mini |
| Ollama 本地 | http://localhost:11434/v1/chat/completions |
qwen2.5:7b |
| LM Studio 本地 | http://localhost:1234/v1/chat/completions |
加载后的模型名 |
注意智谱是个例外:它的路径是 /api/paas/v4/,不是 /v1/。照抄网上的「把 xxx 换成你自己的域名」很容易在这里翻车。
如果你想用中转站:地址就是「中转站给的地址 + /v1/chat/completions」,key 和模型名照中转站控制台抄。
中转站一般会在文档里直接给完整路径,优先用它给的。
模型名有三种写法,别互相套用
Section titled “模型名有三种写法,别互相套用”| 风格 | 例子 | 谁是这样 |
|---|---|---|
| 小写带连字符 | glm-4.7-flash、qwen-plus |
智谱、阿里云百炼 |
| 组织前缀 + 斜杠 | Qwen/Qwen2.5-7B-Instruct、deepseek-ai/DeepSeek-V3 |
硅基流动等聚合平台 |
| 带 tag | qwen2.5:7b、llama3.1:8b |
Ollama |
把 Qwen/Qwen2.5-7B-Instruct 里的组织前缀删掉,是最常见的 model not found 来源。
完整的排查见 model not found 的三种写法差异。
测试不亮绿勾,按这个顺序查
Section titled “测试不亮绿勾,按这个顺序查”- 地址:浏览器新开一个标签,把地址粘进去回车。返回 405 或 401 说明路径对了(只是不接受 GET);返回 404 说明路径错。
- 密钥:重新复制一次,粘贴前先粘到记事本里看首尾有没有空格。详见 401 排查。
- 模型名:去控制台的「模型列表」里复制,不要手打。
- 余额与实名:多数平台不实名不能调用,余额为 0 也会拒。
- 代理:如果浏览器挂了系统代理,请求可能被中间层改写成 GET,表现为奇怪的 404/405。关掉代理再测。
配完还要回页面选一次
Section titled “配完还要回页面选一次”插件里建好服务 ≠ 页面开始用它。回到网页,点悬浮球 → 选「AI 精翻」→ 在下拉里选中刚建的服务名。 不选的话仍然走默认的微软翻译,看起来像「配置没生效」。
地址写到 /chat/completions、模型名从控制台复制、key 首尾不要空格。这三条能解决九成配置失败。