沉浸式翻译接入
沉浸式翻译 是覆盖 Chrome / Edge / Firefox / Safari 的双语翻译插件,支持自定义翻译服务。把它指向 ttttt.ai 后,每次划词或整页翻译都会按 token 计费 —— 没有月费、用多少扣多少。
1. 准备 API Key
登录 app.ttttt.ai → API 密钥 → 创建密钥(命名 immersive-translate)。
2. 添加自定义翻译服务
点浏览器右上角的「沉浸式翻译」图标 → 设置 → 翻译服务:
- 滚到底部 其他 / 自定义 区块 → 点 + 添加自定义翻译服务。
- 选 OpenAI 兼容(自定义)/ Custom AI。
| 字段 | 值 |
|---|---|
| 服务名称 | ttttt.ai |
| 自定义 API 接口地址 | https://api.ttttt.ai/v1/chat/completions |
| API Key | owo-... |
| 模型 | gpt-5.5(短句翻译用 gpt-5.4 更便宜) |
| 自定义模型名称 | 勾选,并把上面的模型 ID 填进去 |
注意接口地址要写完整 path:
https://api.ttttt.ai/v1/chat/completions—— 沉浸式翻译这个字段不会自动拼路径。
- 点 点此测试服务,看到 ✅ 即配通。
- 在 设置 → 基本设置 → 翻译服务 里把默认服务切到
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