Skip to Content
客户端接入沉浸式翻译

沉浸式翻译接入

沉浸式翻译  是覆盖 Chrome / Edge / Firefox / Safari 的双语翻译插件,支持自定义翻译服务。把它指向 ttttt.ai 后,每次划词或整页翻译都会按 token 计费 —— 没有月费、用多少扣多少。

1. 准备 API Key

登录 app.ttttt.ai API 密钥 → 创建密钥(命名 immersive-translate)。

2. 添加自定义翻译服务

点浏览器右上角的「沉浸式翻译」图标 → 设置 → 翻译服务

  1. 滚到底部 其他 / 自定义 区块 → 点 + 添加自定义翻译服务
  2. OpenAI 兼容(自定义)/ Custom AI
字段
服务名称ttttt.ai
自定义 API 接口地址https://api.ttttt.ai/v1/chat/completions
API Keyowo-...
模型gpt-5.5(短句翻译用 gpt-5.4 更便宜)
自定义模型名称勾选,并把上面的模型 ID 填进去

注意接口地址要写完整 pathhttps://api.ttttt.ai/v1/chat/completions —— 沉浸式翻译这个字段不会自动拼路径。

  1. 点此测试服务,看到 ✅ 即配通。
  2. 设置 → 基本设置 → 翻译服务 里把默认服务切到 ttttt.ai

3. 翻译策略调整

整页翻译会触发大量并发请求,几十段同时发出去。建议:

  • 给这把密钥的 RPM 限速调到 ≥ 60(控制台 → 密钥 → 编辑 → 速率限制)。
  • 在沉浸式翻译里,翻译服务 → 高级设置 → 每秒最大请求数 设为 5–10, 避免触发 429。
  • 短文档默认用 gpt-5.4 节省成本,遇到难句再单独换 gpt-5.5

4. 文档翻译(PDF / EPUB)

沉浸式翻译 Pro 支持上传 PDF / EPUB 整本翻译,请求量更大。 建议给”批量翻译”单独建一把密钥,配低 RPM + 月度预算告警, 避免循环失控烧钱。详见 余额告警

5. 常见问题

Q: 测试服务提示 401? A: 检查密钥是否被吊销 / 额度用尽; 也确认 API 接口地址是 /v1/chat/completions 完整路径。

Q: 测试服务提示 “model not found”? A: 自定义模型名称必须完全匹配 ttttt.ai 公开的 ID, 当前是 gpt-5.5 / gpt-5.4,区分大小写。

Q: 翻译质量怎么调? A: 沉浸式翻译插件的 专家模式 → 自定义 prompt 里可以改 system prompt, 比如要求「专业术语保留英文原文」「不翻译代码块」等。

Q: 流式翻译比非流式慢? A: 流式翻译每段都开一条 SSE 长连,并发高时浏览器自身会限制连接数。 对页面翻译这种「短段大批量」的场景,把流式关掉反而更快。

Last updated on