调用DeepL API仅返回单条翻译 如何获取多候选替代译法

核心原因 #

DeepL API默认仅返回1条最优翻译结果，桌面/网页端的多替代译法属于附加功能，需要额外传参开启，和免费/付费API版本无关。

解决方法 #

发起请求时新增alternatives参数，参数值为你需要的最多替代译法数量，最高可设置为5。

注意事项 #

• 免费版API完全支持该参数，没有权限限制
• 实际返回的替代译法数量不一定完全匹配你设置的参数值：文本过短、语义指向性极强的内容可能仅返回1-2条结果，甚至没有额外替代译法
• 你此前测试时拿到过多条结果，大概率是当时请求携带了该参数，未携带的情况下默认仅返回单条译法

请求示例（POST Body） #

{
  "text": ["你要翻译的原文内容"],
  "source_lang": "EN",
  "target_lang": "ZH",
  "alternatives": 3
}

内容的提问来源于stack exchange，提问作者ByteCarp