跳到主要内容
Router One

给沉浸式翻译换一个更省的翻译引擎

沉浸式翻译支持网页、PDF、电子书和字幕的双语对照。将它的自定义 OpenAI 兼容接口接到 Router One,并选择支持 Chat Completions 的模型。先核对当前单价、验证一小段翻译,再处理完整文档;网关 Trace 会记录每次请求的 token 用量和费用。

把 Immersive Translate 配置到 Router One base URL

打开沉浸式翻译 设置 → 翻译服务 → OpenAI,把 API Key 切换为「自定义 API Key」,展开更多自定义选项,填「自定义 API 接口地址」——注意要填含 /chat/completions 的完整路径,不是只填 base URL——再把「自定义模型」填成 /models 页的模型 ID:

immersive-translate-settings
# Immersive Translate → Settings → Translation Services → OpenAI
# 沉浸式翻译 → 设置 → 翻译服务 → OpenAI
API Key type(API Key 类型):  Custom API Key(自定义 API Key)
APIKEY:  sk-your-router-one-key
Custom endpoint(自定义 API 接口地址,须含 /chat/completions):
  https://api.router.one/v1/chat/completions
Custom model(自定义模型):  <model-id-from-/models>

Immersive Translate 该填哪个模型 ID?

从 /models 页复制精确的模型 ID,保留大小写、连字符和版本后缀,不要用展示名称代替。打开该模型的详情页,核对支持的 API 端点、上下文窗口和工具调用等能力,再与 Immersive Translate 当前选择的 provider 和功能对应。模型出现在目录里,不等于当前客户端能调用它的所有功能。建议为每个工具单独建 API Key,并设置 maxSpend 消费上限。

Immersive Translate 用的是哪种 API 协议?

OpenAI 兼容描述的是接口格式,不能据此推断 Chat Completions(/v1/chat/completions)、Responses(/v1/responses)和 Anthropic Messages(/v1/messages)可以互换。先核对工具当前版本、provider 配置和实际请求路径,再查模型详情与 API 兼容性事实页。一次普通对话成功,也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在 trace 里验证 Immersive Translate 的调用

先在 Immersive Translate 发出一次简单文本请求,再到 Dashboard → Logs 按时间、模型和 request_id 核对 trace:tokens、花费、延迟和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id;没有对应日志时,先查客户端配置和网络,不能仅凭客户端报错认定是网关或上游故障。

常见问题

「自定义 API 接口地址」填 base URL 为什么不行?

沉浸式翻译的「自定义 API 接口地址」要求带 /chat/completions 的完整路径——https://api.router.one/v1/chat/completions,而不是大多数 SDK 用的 /v1 base URL。翻译立刻报错时先检查这个后缀,再核对模型 ID 与 /models 页完全一致。

Immersive Translate 能通过网关用哪些模型?

选用当前目录中同时支持 Immersive Translate 所用端点和所需功能的模型。精确 ID、当前单价与能力以 /models 及模型详情为准;不要仅按 GPT、Claude 等系列名判断兼容性。客户端能列出模型,只证明模型发现成功,仍需验证实际调用。

能列出模型,但调用报 400 或 404,怎么办?

先记录实际请求路径和错误消息,再核对精确模型 ID。400 可能是参数、工具类型或模型与端点不匹配;404 可能是请求路径或资源不存在,不能直接判定模型下线。若错误提示 must be called via,按它指明的端点调整客户端 provider,或换用支持当前端点的模型。不要在所有工具里统一增删 /v1 或 /chat/completions。

中国大陆能直连吗?

能。网关在大陆可直连、无需 VPN,配置与全球环境完全一致。

报 401/402/403/429 怎么排查?

先到 Dashboard → Logs 核对请求及错误消息。401 查 Key 是否传入和有效;402 查钱包余额与 maxSpend;403 查 Key 权限和访问限制;429 查请求频率、token 限额及上游限流,按错误来源处理。保留 request_id,再按错误码速查页逐项排查。