跳转到内容

沉浸式翻译自定义 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,报方法不允许
服务商 接口地址 模型名示例
智谱 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 的三种写法差异。

  1. 地址:浏览器新开一个标签,把地址粘进去回车。返回 405 或 401 说明路径对了(只是不接受 GET);返回 404 说明路径错。
  2. 密钥:重新复制一次,粘贴前先粘到记事本里看首尾有没有空格。详见 401 排查。
  3. 模型名:去控制台的「模型列表」里复制,不要手打。
  4. 余额与实名:多数平台不实名不能调用,余额为 0 也会拒。
  5. 代理:如果浏览器挂了系统代理,请求可能被中间层改写成 GET,表现为奇怪的 404/405。关掉代理再测。

插件里建好服务 ≠ 页面开始用它。回到网页,点悬浮球 → 选「AI 精翻」→ 在下拉里选中刚建的服务名。 不选的话仍然走默认的微软翻译,看起来像「配置没生效」。

地址写到 /chat/completions、模型名从控制台复制、key 首尾不要空格。这三条能解决九成配置失败。