在沉浸式翻译中使用 APIMart

​

准备工作

在开始之前，请确保：

1. 已安装沉浸式翻译扩展
   从以下平台安装沉浸式翻译：
   • Chrome 应用商店
   • Edge 扩展商店
   • Firefox 附加组件
   • 官方网站
2. 已获取 APIMart API 密钥
   登录 APIMart 控制台 获取您的 API 密钥（以 sk- 开头）

​

第一步：打开扩展设置

安装沉浸式翻译扩展后：

1. 点击浏览器工具栏中的 沉浸式翻译 图标
2. 在弹出的面板底部，点击左下角的 设置 按钮
3. 进入沉浸式翻译的设置页面

​

第二步：配置翻译服务

​

2.1 进入翻译服务设置

在设置页面中：

1. 在左侧菜单找到 “翻译服务” 选项
2. 点击进入翻译服务配置页面

​

2.2 添加自定义翻译服务

在翻译服务列表页面：

1. 点击页面上方的 + 添加自定义翻译服务 按钮
2. 在配置表单中填写 APIMart API 信息

​

2.3 配置 APIMart API 信息

填写以下配置信息：

​

第三步：保存并选择翻译服务

配置完成后：

1. 点击配置页面底部的 保存 按钮
2. 返回扩展面板，在 翻译服务 下拉菜单中选择 APIMart
3. 您可以在 AI 专家 中选择翻译风格（如”通用”）

​

推荐模型

不同模型适合不同的翻译场景： 可用模型：

• gpt-5 - 最新模型，翻译质量最高 ⭐ 推荐
• gpt-4o - 高质量翻译，速度快
• gpt-4o-mini - 经济实惠，适合大量翻译 💰 性价比之选
• claude-sonnet-4-5-20250929 - 文学翻译效果好
• claude-haiku-4-5-20251001 - 快速翻译，性价比高

​

第四步：开始使用翻译

配置完成后，您可以开始使用沉浸式翻译：

​

4.1 网页翻译

1. 打开任意外文网页
2. 点击浏览器工具栏的沉浸式翻译图标
3. 选择 翻译此页 或使用快捷键（默认：Alt+A）

​

4.3 PDF 翻译

沉浸式翻译支持在线 PDF 文件翻译：

1. 在浏览器中打开 PDF 文件（在线 PDF）
2. 点击沉浸式翻译图标打开扩展面板
3. 点击 点击翻译 PDF (Alt+A) 按钮
4. 等待翻译完成，PDF 将显示双语对照

​

4.4 视频字幕翻译

支持主流视频平台的实时字幕翻译：

1. 打开 YouTube、Netflix 等视频平台
2. 播放视频，沉浸式翻译自动识别字幕
3. 自动生成双语字幕显示

支持平台：

• 🎬 YouTube
• 📺 Netflix
• 🎥 Coursera
• 📹 Udemy
• 🎓 edX

​

高级功能

​

自定义翻译规则

在设置中可以配置丰富的个性化选项： 基本设置：

• 翻译服务 - 选择默认翻译服务（APIMart）
• AI 专家 - 选择翻译风格（通用、专业、文学等）
• AI 术语库 - 管理专业术语翻译

高级选项：

• 网站规则 - 为特定网站设置自动翻译规则
• 翻译样式 - 自定义译文颜色、字体等显示样式
• 鼠标悬停设置 - 配置 Ctrl + 鼠标悬停显示原文
• 划词翻译 - 设置选中文本后的翻译行为
• 输入框增强 - 在输入框中启用实时翻译

​

快捷键设置

沉浸式翻译提供便捷的快捷键操作：

​

翻译模式

沉浸式翻译提供多种灵活的翻译显示模式：

​

常见问题

​

Q1: 配置后翻译没有反应？

解决方案：

1. 检查翻译服务选择：
   • 打开扩展面板，确认”翻译服务”下拉菜单中选择了 APIMart
   • 如果看不到 APIMart，返回设置页面检查是否保存配置
2. 检查 API Key：
   • 确认 APIKEY 正确且以 sk- 开头
   • 在 APIMart 控制台 检查密钥是否有效和是否有余额
3. 检查 API 接口地址：
   • 必须填写完整路径：https://api.apimart.ai/v1/chat/completions
   • 注意不是 /v1 而是 /v1/chat/completions
4. 检查模型名称：
   • 确认模型名称正确（如 gpt-4o-mini、gpt-5）
   • 模型名称区分大小写

​

Q2: 翻译速度慢或超时？

解决方案：

1. 调整每秒最大请求数：
   • 在配置中将”每秒最大请求数”降低到 3
   • 避免并发请求过多导致超时
2. 切换更快的模型：
   • 使用 gpt-4o-mini（速度快且经济）
   • 或使用 claude-haiku-4-5-20251001
3. 检查网络连接：
   • 确保网络稳定，避免频繁断线
   • 大型页面建议分段翻译
4. 关闭不必要的功能：
   • 暂时关闭”启用 AI 插画”等增强功能
   • 减少 API 调用次数

​

Q3: 翻译质量不理想？

解决方案：

1. 选择更高质量的模型：
   • 使用 gpt-5（最新最强）或 gpt-4o（高质量）
   • 文学、专业内容推荐 claude-sonnet-4-5-20250929
2. 调整 AI 专家设置：
   • 在扩展面板中选择合适的”AI 专家”
   • 专业文档选择”专业”，日常内容选择”通用”
3. 使用术语库：
   • 在设置中配置”AI 术语库”
   • 添加专业术语的首选翻译，确保一致性
4. 启用 AI 上下文增强：
   • 在自定义服务配置中启用”AI 智能上下文”
   • 提供更准确的语境理解

​

Q4: 某些网站无法翻译？

解决方案：

1. 检查网站兼容性：
   • 某些动态加载的网站可能需要刷新页面
   • SPA（单页应用）可能需要手动触发翻译
2. 添加网站规则：
   • 在设置的”网站规则”中添加特定网站配置
   • 指定翻译区域和排除区域
3. 尝试不同翻译模式：
   • 切换为”鼠标悬停”或”划词翻译”模式
   • 某些网站在特定模式下效果更好

​

Q5: 如何查看翻译消耗？

登录 APIMart 控制台 查看详细统计：

• 📊 API 调用统计 - 实时查看调用次数和频率
• 💰 费用明细 - 每次调用的详细费用记录
• 📈 使用趋势 - 按日期/模型查看使用情况
• 🔍 请求日志 - 详细的请求和响应记录

​

使用技巧

​

1. 智能选择翻译服务

根据不同场景选择合适的模型：

• 📚 学术论文、技术文档：使用 gpt-5 确保准确性
• 📰 新闻文章、博客：使用 gpt-4o 平衡质量和速度
• 💬 社交媒体、日常浏览：使用 gpt-4o-mini 节省成本
• 🎨 文学作品、创意内容：使用 claude-sonnet-4-5-20250929

​

2. 配置网站自动翻译

设置常访问网站的自动翻译规则：

1. 打开设置 → 网站规则
2. 添加网站域名（如 github.com）
3. 设置为”总是翻译”或”总是不翻译”
4. 保存后，访问该网站时自动应用规则

​

3. 使用划词翻译精准查询

对于大段文本中的部分内容：

1. 启用”划词翻译”功能
2. 选中需要翻译的文本
3. 查看精准翻译结果
4. 避免翻译整个页面，节省 API 调用

​

4. 优化翻译质量

配置术语库：

• 在设置中添加专业术语
• 确保技术名词翻译一致性
• 支持多个术语库分类管理

选择合适的 AI 专家：

• 技术文档选择”专业”或”技术”
• 日常内容选择”通用”
• 文学作品选择”文学”或”创意”

​

5. 节省 API 费用

成本控制策略：

• ✅ 使用 gpt-4o-mini 作为日常浏览默认模型
• ✅ 只在重要文档时切换到 gpt-5
• ✅ 配置”每秒最大请求数”为 3-5，避免超限
• ✅ 使用”仅是翻译这网站”功能，控制翻译范围
• ✅ PDF 翻译时选择需要的页面范围
• ❌ 避免频繁刷新已翻译的页面

​

功能特性

使用沉浸式翻译 + APIMart，您可以：

• 🌐 网页翻译 - 双语对照显示，保持原网页排版
• 📄 PDF 翻译 - 支持 PDF 文档在线翻译
• 🎬 视频字幕 - YouTube、Netflix 等平台双语字幕
• ✍️ 划词翻译 - 选中即翻译，快速理解
• 📧 输入增强 - 在输入框中直接翻译
• 📱 全平台支持 - Chrome、Edge、Firefox、Safari 等
• 🎨 自定义样式 - 调整译文显示效果
• ⚡ 快捷操作 - 丰富的快捷键支持

​

支持与帮助

如果您在使用过程中遇到任何问题：

• 📚 APIMart 文档中心
• 📚 沉浸式翻译文档
• 💬 Discord 社区
• 🐦 Twitter @APIMart_
• 📧 技术支持：zhihong@apimart.ai

---

开始使用 APIMart

立即注册 APIMart，获取您的 API 密钥，享受高质量翻译服务！