模型与回退

为语言对选择模型,了解某个候选模型无法完成请求时,系统会接着尝试哪个模型。

本地化引擎的模型配置解决两个问题:由哪个模型翻译某个语言对,以及该模型无法完成请求时应尝试哪个模型?回退用于应对执行失败,而不是生成多个译文,再从中选出质量评分最高的一个。

网页应用的创建表单默认使用推荐的主模型和回退模型,覆盖所有语言区域对。你可以保留这一全面覆盖的配置,也可以在创建时或之后设置更有针对性的配置。

选择模型及其覆盖范围 #

请通过配置界面或账户 MCP 中的受支持模型目录,查看最新的模型标识符和上下文限制。模型的可用性会变化,复制保存的列表可能过时。如果你有 Mistral AI 密钥,配置界面还会列出该密钥可访问、但未收录在目录中的聊天模型;请参阅目录之外的模型。

精确的模型标识符对应某个特定模型,而动态别名日后可能指向不同的模型。固定模型选择有助于清楚说明所用的模型,但不能确保输出完全一致,也不能证明该模型适合你的内容。

配置源语言区域与目标语言区域的配对。使用通配符设置通用的默认覆盖范围;如果某个语言对需要使用不同的候选模型,则为其指定具体的语言区域。请确认重要的语言对都有适用配置;重试无法弥补模型配置的缺失。

了解尝试顺序 #

本地化引擎依次按以下因素对候选模型排序:

  1. 目标语言区域的匹配层级。
  2. 源语言区域的匹配层级。
  3. 目标语言区域的具体程度。
  4. 源语言区域的具体程度。
  5. 配置的排序值。

排序值为 1 并不意味着能优先于语言区域匹配度更高的配置。例如,专门针对英语到 de-CH 的配置可能优先于覆盖范围较广的通配符配置,即使后者更早录入。语言区域解析说明了哪些语言区域适用于某个请求、不带地区的语言标识如何代表其默认地区,以及匹配层级如何决定它们的顺序。

每次尝试都有执行时限。某个候选模型失败或超时后,可以继续尝试下一个;如果整条回退链都未能完成请求,请求就会失败。回退可以减少对单一模型的依赖,但无法弥补覆盖范围的缺失,也无法在所有候选模型都失败时保证请求成功。

将质量与可靠性分开比较 #

通过请求证据确认实际使用的模型,以及是否触发了回退。提供商拒绝请求、配置出错,以及翻译虽已完成但不适用,这些情况需要分别采取不同的解决措施。

如需使用组织自己的密钥运行提供商的模型,请参阅 BYOK。Lingo.dev API 密钥和外部提供商凭证分别用于授权不同的服务;选择模型并不会建立凭证连接。

翻译 API 参考介绍了 JSON 内容和上下文字段。每个任务都需要一个 engineId。请确认所选引擎已启用,且配置的模型覆盖请求中的每个语言区域对。查看任务的模型尝试记录,确认每个批次实际由哪个模型处理。