登录

翻译模型配置说明

本教程用于说明精挑翻译插件中各类大模型的配置方式及相关参数含义，涵盖 API Key、接口地址、模型选择、性能参数与提示词设置等内容。通过合理配置模型参数，可有效提升插件对大模型服务的稳定性，并在不同翻译场景下改善翻译准确性、响应效率与整体使用体验。


1. 配置 API Key

API Key 是模型服务商提供的官方访问凭证，用于安全调用其人工智能模型与相关服务。

常见 API Key 配置问题

  • API Key 格式不正确：API Key 可能存在缺失字符、多余空格或被错误截断的情况。请确认完整复制官方提供的 Key，避免在前后包含空格、换行符或其他无效字符。
  • API Key 与模型服务商不匹配：不同模型服务商的 API Key 互不通用，例如 OpenAI 的 API Key 不可用于 DeepSeek 模型。
  • API Key 已失效或被禁用：API Key 可能因过期、手动禁用、账号异常、额度上限或安全原因被撤销。可前往服务商控制台确认 API Key 的状态是否正常。
  • 接口地址配置错误：API Key 本身正确，但接口地址填写错误、缺失版本路径，或与服务商要求的地址不一致，也会导致检测失败。
  • 模型名称配置不正确：所填写的模型名称与服务商实际支持的模型不一致，或拼写错误，可能被误认为 API Key 无效。
  • 网络或代理配置异常：本地网络、代理设置或防火墙限制可能阻止请求正常发送，表现为鉴权失败或请求超时。

2. 翻译模型选择

在配置插件时，模型名称必须与 API Key 所属服务商一致，否则将无法正常调用。

常见服务商与模型对应关系

服务商模型名称
OpenAIgpt-5、gpt-5-mini、gpt-5-nano
Geminigemini-2.5-flash、gemini-2.0-flash-lite

💡 建议通过下拉菜单选择模型名称；如需手动输入，请确保模型名称与服务商具体的模型 ID（如 gpt-5、gpt-5-mini）一致。

3. 自定义 API 接口地址

插件默认配置了官方 API 地址，通常无需调整。若用于以下情况，才需手动填写对应的接口地址：

  • 通过反向代理或中转服务调用模型；
  • 使用私有化部署的大模型服务；
  • 接入未完全采用官方默认地址的第三方 API 服务。

填写规范：

  • 地址必须为完整的 HTTPS 接口地址，例如：https://api.your-company.com/v1/chat/completions
  • 接口路径需与对应服务商的技术文档保持一致，并确保该接口能够正确接收和处理符合接口规范的请求格式。

4. 模型参数调整

以下参数用于调节翻译的质量、模型稳定性和响应速度。 默认配置已覆盖大多数使用场景，如有特殊需求，可根据实际情况进行调整。

参数说明推荐设置
每次请求的最大文本长度用于限制单次翻译请求中可提交的最大字符数。设置过大可能导致接口响应变慢，合理控制该值有助于提升翻译的稳定性与响应速度。- 推荐 1000–1500 字符
- 避免超过 2000 字符，以防响应延迟或内容丢失。
每次请求的最大段落数单次翻译请求中可同时提交的段落数量。段落数量过多可能增加请求处理负载，导致接口响应变慢或稳定性下降；合理设置有助于提升整体翻译效率与稳定性。- 技术文档/法律文本：1（逐段处理，确保术语准确）
- 小说/对话/博客：3–5（提升流畅性）
每秒最大请求数每秒发起的翻译请求次数。当请求频率过高时，新增请求将进入队列等待，以避免触发接口限流并提升整体运行稳定性。- 通用使用：25
- 限流严格服务（如 Gemini）：8–10
温度用于控制模型输出的随机性与发散程度。较高的温度值会产生更加多样、灵活的表达；较低的温度值则使输出更加稳定，更适合追求一致性和准确性的翻译需求。- 翻译任务推荐：每个模型的官方推荐温度不一致，建议使用提供的默认温度；可按需要进行调整

💡 建议调整参数后，通过相同的原文进行对比测试，以便更准确地评估调整后对翻译效果的影响。

5. 自定义提示词（System Prompt/User Prompt）

插件内置经过优化的通用翻译提示词，能够满足大多数常见翻译场景的需求。 当存在特定要求时（例如译文风格、术语一致性、专业领域或语气偏好），可通过自定义提示词对模型的输出结果进行精细化控制。

在编写自定义翻译提示词时，建议遵循以下原则：

  • 提示内容清晰明确：明确指定目标语言、翻译风格、所属领域，以及需要避免的表达方式或用词倾向。
  • 指令具备可执行性：使用具体、明确的描述，避免含糊或抽象的表述，确保模型能够准确理解并执行指令。
  • 合理控制提示长度：提示词应在信息充分的前提下保持简洁，避免冗余描述对模型理解造成干扰。

💡 如有疑问或建议，建议参考服务商官方文档或前往 问题反馈 页面进行反馈。

6. 免责声明

⚠️ 【使用自定义 API Key】模式所产生的费用将由对应服务商根据实际使用情况进行结算。本扩展仅负责提供调用能力，不会向您收取任何额外费用。

🔔 请注意相关服务商提供的免费额度和所产生的费用，避免额外扣费。

翻译额度 (TQ) 与模型 Token 的换算

翻译模型配置流程