APIPace 文档 API 参考

接入沉浸式翻译

沉浸式翻译(Immersive Translate)用自定义 AI 服务接过来,网页翻译就走这里的模型。

配置

两条入口,选一条:

新建一个服务:设置 → 翻译服务 → 添加自定义翻译服务 → 自定义AI(在「其他 / 自定义」分组里)。

改现有的 OpenAI 服务:设置 → 翻译服务 → OpenAI → 自定义 API Key → 展开更多自定义选项 👉。

两条路要填的字段一样:

字段 填什么
APIKEY 你的 ak-…
自定义 API 接口地址 https://api.apipace.com/v1/chat/completions
模型 别名,如 kimi-k3

填完点「点击测试」验证,通过后保存。

地址填完整路径

这个字段新版本既接受 base URL 也接受完整接口地址,但官方示例一直用的是完整路径,对所有版本都安全。填 https://api.apipace.com/v1/chat/completions,别只填到 /v1。

模型要手填

它从不自动拉模型列表。下拉最后一项「自定义模型列表」支持一点语法:+别名 加一个、-别名 藏一个、-all 藏掉全部内置的。比如:

-all,+kimi-k3,+claude-sonnet-4.6

选便宜的别名

网页翻译是高频、小请求的负载:一篇长文会被切成几十段并发发出去。别用最贵的模型翻网页,kimi-k3 这类国产别名在这个场景上性价比好得多。

把插件的并发 / 每秒请求数调到这把 key 的每秒上限以内,否则会成片拿到 RATE_LIMITED(429)。平台默认每 key 30 次/秒,控制台的 API Key 页可以给这把 key 单独设更严的值。

建议单开一把 key

给翻译插件单独发一把 key,并在控制台给它设一个只含便宜别名的模型白名单。这样即使配置被误改成贵模型,也会直接 PERMISSION_DENIED,而不是安静地多花钱。

想用 Claude 原生协议

插件的 Claude 服务也支持自定义地址:设置 → 翻译服务 → Claude → 自定义 Auth Key → 展开更多自定义选项,把「自定义 API 接口地址」改成 https://api.apipace.com/v1/messages(它走的是原生 Messages 协议,不是 OpenAI 形状)。

常见问题

测试不通过 —— 地址没写全(漏了 /v1/chat/completions),或模型名不是别名。

翻译到一半大面积失败 —— 多半是 429。看响应里的 Retry-After,把并发调小。

费用比想象的高 —— 网页翻译的请求数很多。用 GET /v1/user/statement 的 models[] 看是哪个别名在花钱。