在调用DeepL API时使用context参数，建议先识别哪些翻译请求属于短文本或可能包含多义词，为这些请求单独构建上下文信息。可以提供待翻译文本所在的完整段落或前后几句相关内容作为context，确保这段补充信息与待翻译内容紧密关联。context参数应与其他定制化功能配合使用：术语表确保核心术语统一，custom_instructions控制译文语气和风格，context解决短文本的语境缺失问题。需要注意的是，context参数会与同请求中的其他参数协同生效，context的语境信息与custom_instructions的指令功能互不干扰但各司其职。在涉及人物职业、称谓等需区分语法性别的翻译任务中，主动在context中提供明确的性别线索可以避免默认选择错误。对于新闻标题、产品列表等包含专有名词的重复翻译场景，为所有相关请求提供包含完整名词的context有助于保持音译一致性。上下文信息本身不计费，因此可以放心提供足够长度的补充内容，让翻译结果更加符合预期。通过合理运用context参数，短文本翻译的准确度和一致性可以得到有效改善。
context参数的核心用途与工作机制
为待翻译文本补充缺失的语境信息
context参数允许用户在调用DeepL API翻译文本时额外提供一段上下文信息，帮助翻译引擎更准确地处理那些本身缺乏足够语境的短文本。这段补充内容本身不会被翻译，也不计入字符计费限额，但它为API提供了理解待翻译词汇或短句所需的环境信息。其运作方式类似于向人类译者展示待翻译句子前后段落的过程，让模型在翻译时能够参考更完整的语义场，从而输出更贴合原始意图的译文。context参数的计费豁免特性也使得用户可以放心提供较长的上下文补充内容而无需担忧额外费用。
与术语表和风格规则的互补定位
context参数与DeepL API提供的术语表和custom_instructions功能形成互补关系，各自解决不同层面的翻译问题。术语表用于确保特定词汇（如品牌名称、专业术语）始终按指定方式翻译，解决术语一致性问题。custom_instructions参数用于以自然语言指令控制译文的语气、风格和格式规范（例如“使用友好、外交辞令式的语气”），但不适用于提供文档语境。context参数则专注于为待翻译文本补充短时语境信息，主要用于多义词消歧、语法性别判断和专有名词音译一致性等场景。三者在实际使用中可以相互配合，但同时需要明确区分各自的适用范围，避免将语气指令误放入context参数中。
官方正式发布与全API用户可用
DeepL API的context参数功能在经历了测试阶段后已正式发布，现可供所有API用户使用。该功能获得了Weglot和Kicktipp等早期测试客户的积极反馈，他们称赞该功能显著提高了翻译质量，尤其对产品名称和描述等短文本的翻译效果提升明显。用户可以直接在API请求中添加context参数使用该功能，无需额外设置或配置，开发人员可以轻松将其集成到现有的翻译工作流中。官方API文档已针对此功能进行更新，提供了详细的使用指南和示例。
消除多义词在不同语境中的歧义场景
多义词消歧的典型应用
当待翻译文本包含多义词且缺乏足够语境时，context参数能够帮助翻译引擎在多个可能含义中做出正确选择。根据DeepL官方文档中的示例，德文单词”Tor”既可指”大门”也可指”进球”。当单独翻译”Die Person stand vor dem Tor.”这句德文时，DeepL可能会输出”The person was standing in front of the gate.”（大门）。但如果在翻译请求中通过context参数提供”Es war ein Fußballspiel.”（这是一场足球比赛）作为上下文信息，DeepL能够准确判断”Tor”在此处应译为”goal”（进球）。这种机制在翻译产品名称、新闻标题和UI界面文案等短文本时同样有效。
适合使用该方法的场景类型
context参数特别适合那些源文本本身缺乏独立语境的翻译任务。当翻译短小的文本片段时，单独的几个词或一句话往往不足以让翻译引擎准确判断词义和表达方向。电商平台的产品名称和描述翻译是典型的受益场景，因为这些内容通常简短且依赖前后文信息才能确定准确的翻译方向。新闻标题的翻译同样适用，因为标题本身往往高度凝练，需要结合正文内容才能准确理解其含义。当翻译的内容包含多个可能含义的词汇时，提供周围内容作为context可以有效减少词义选择错误。
电商与内容平台的典型应用案例
在电商和内容平台的翻译场景中，context参数的价值尤为突出。DeepL官方博客指出，该功能特别有利于电商平台，因为在这些平台上精确的命名规则或产品描述对良好的购物体验至关重要。例如，翻译一个产品名称”Apple”时，如果不提供上下文，DeepL可能无法判断这是水果名称还是科技品牌名称。通过context参数提供产品类别或描述信息，DeepL能够准确选择对应的翻译方式。早期测试用户反馈表明，该功能在优化电商产品名称和描述翻译方面效果显著。
为目标语言中有语法性别的词汇提供线索
语法性别不明确时的解决方案
当源语言（如英语）不标记名词的语法性别，而目标语言（如德语、法语、西班牙语等）有性别区分时，context参数能够提供关键线索。根据DeepL官方文档中的示例，英文句子”The teacher asked the class to tidy up after they finished the lesson.”中，”teacher”的性别未被指定。仅翻译该句时，DeepL在德语中可能会默认使用阳性形式”Lehrer”。但如果通过context参数提供”She did not want to tidy up herself.”这样的语境信息，翻译引擎就能推断出所指教师为女性，从而在译文中正确使用阴性形式”Lehrerin”。
涉及职业称谓和人物的翻译场景
context参数在翻译涉及人物职业、称谓或角色的短文本时非常有价值，能够显著提升译文的自然度和准确性。当翻译包含”doctor”、”professor”、”nurse”等职业名词的短句时，如果源文本没有明确指出性别，context参数可以帮助翻译引擎在目标语言中选择正确的性别形式。这一机制尤其适用于翻译人物简介、员工介绍、角色对话等涉及具体人物的内容。DeepL官方文档指出，当需要翻译成带有语法性别的目标语言且源文本未明确性别时，应主动在context参数中提供周围句子中包含的性别线索。
如何在context中提供性别线索
为了有效利用context参数解决性别问题，用户需要在context中提供明确指向人物性别的信息。这些线索可以来自待翻译文本周围的句子中的人称代词（如”she”、”he”）或称呼方式。例如，当翻译包含某位教师的内容时，如果前后文中提到了”she”或”her”，将这些内容作为context传递给API即可帮助确定正确的性别形式。用户只需在API请求中添加一个包含相关线索的context字符串即可，这段内容本身不会被翻译，也不会消耗字符配额。
保持专有名词音译一致性的应用
音译不一致问题的根源
当翻译同一篇文档中分散出现的专有名词时，DeepL可能对同一个名字给出不同的音译或转写结果，导致译文不一致。根据DeepL官方文档的说明，这是因为API请求中每个text数组中的字符串是独立翻译的，不同文本之间不共享语境信息。如果将标题和正文分开翻译，DeepL可能对同一个名字给出不同的音译版本。例如，人名”Sergej Zhivkov”在德语中可能被音译为”Sergei”或”Sergej”等不同变体，当标题和正文分别翻译时可能得到不一致的结果。
通过context实现音译统一
通过在翻译请求中添加包含完整姓名的context参数，DeepL能够输出统一的音译版本。DeepL官方文档展示的示例中，当分别翻译”Sergej gibt Stellungnahme ab”和”Sergej Zhivkov erklärte gestern, dass neue Maßnahmen ergriffen werden.”这两条文本时，同一人名出现了不同的音译结果。但当为所有相关翻译请求提供包含完整姓名的context后，DeepL能够输出统一的音译结果。这一方法在翻译新闻报道（标题与正文分离）、技术文档或任何包含专有名词的拆分内容时尤为重要。
适用场景与实际操作建议
context参数在专有名词音译一致性方面的应用，特别适合那些将长文档拆分为多个短文本分别翻译的场景。新闻翻译中标题和正文分开处理是典型的应用场景，通过为标题翻译提供包含完整人名的context，可以让标题和正文中的同一人名使用一致的音译版本。技术文档中的人名、地名和机构名称翻译同样适用这一策略。实际操作中，建议维护一个包含所有专有名词及其标准音译的上下文缓冲区，在翻译相关短文本时将其作为context传递，以确保整篇文档的术语风格统一和专业性。
context参数的API调用方法与常见误用
在API请求中添加context参数
在调用DeepL API的文本翻译端点时，用户只需在请求体中添加一个额外的context参数即可。该参数接受一个字符串值，内容为与待翻译文本相关的补充信息。在DeepL官方文档提供的curl示例中，用户在JSON请求体中添加"context": "Es war ein Fußballspiel."即可为翻译提供上下文。context参数在DeepL的所有官方客户端库中均受支持，同时也被第三方开发者在R语言的deeplr包和Dart语言的deepl_dart包等工具中广泛集成。使用该功能不需要额外的设置或配置，开发人员可以轻松地将其集成到现有的翻译工作流中。
常见误用：将context当作系统指令
context参数的设计目的常被误解，导致用户将其当作类似LLM系统提示词（system prompts）的指令输入，从而产生不可预测的结果。DeepL官方文档明确指出，像”用友好、非正式的语气翻译”或”始终将‘Tor’翻译为‘gate’”这类指令不应放入context参数中，因为该参数优化的是基于文档内容的语境理解，而非执行用户指令。将指令类文本放入context会产生不可预测的翻译结果，因为模型会试图将这些指令当作待翻译内容的语境来处理而非作为指导规则。风格和语气方面的指令应使用custom_instructions参数或风格规则，术语层面的强制约束应使用术语表。
context与custom_instructions的参数分工
为了正确使用DeepL API的各项定制功能，用户需要明确理解context和custom_instructions的分工定位。context参数用于为待翻译文本提供短时语境信息，解决多义词歧义、语法性别判断和专有名词音译一致性问题，放入的内容应该是真实的文档上下文片段而非指令。custom_instructions参数则用于以自然语言指令控制翻译的语气、风格和格式（如”使用适合移动应用的友好语气”），每条指令最多300字符，每个请求最多10条，支持德语、英语、西班牙语、法语、意大利语、日语、韩语和中文等目标语言。术语表用于确保特定词汇始终按指定方式翻译，三者功能互不重叠。context不会计入字符计费，而custom_instructions和术语表同样不计费。
提供有效context信息的实践建议
提供紧密关联的真实上下文
为了充分发挥context参数的效果，开发者应提供与待翻译文本紧密相关的真实上下文信息。DeepL官方文档建议，提供待翻译文本所在的完整段落或前后几句相关内容作为context，确保这段补充信息与待翻译内容紧密关联。在电商场景中，产品名称的翻译可以附带产品类别、描述或用户评价等上下文信息。在UI本地化中，短按钮标签可以附带其所在页面或菜单的前后文本。行业相关的术语和表达偏好也可以通过context传递语境，从而有效提升翻译的精准度。DeepL官方文档指出，context参数对于短小且缺乏独立语境的源文本尤其有效。
上下文缓冲区方法的实践
在实际开发中，一种有效的实践方式是维护一个”上下文缓冲区”，存储最近翻译请求的源语言内容，并将其作为后续短文本翻译的context。当翻译同一篇文档、同一批新闻或同一电商类目下的多个产品时，维护这样一个包含相关内容的缓冲区可以显著提升翻译一致性。具体操作上，可以存储当前文档的段落标题、前几句内容或产品的类目名称等关键信息，在翻译短文本时将其作为context传递给API。这种方法尤其适合处理同一来源或同一主题下的大量短文本翻译任务，让每次翻译都能享受到前后文带来的语境增益。
选择适合的场景应用context
context参数并非适用于所有翻译请求，识别哪些内容需要补充语境是有效使用的关键。context参数最适用于翻译短小且缺乏独立语境的内容，如产品名称、按钮文案、文章标题、UI字符串和技术术语等。对于包含完整段落的翻译请求，由于源文本本身已经包含了足够的语境信息，context参数带来的增益相对有限。DeepL官方文档也指出，包括更多语境内容通常会带来更高质量的翻译，而context参数是短文本翻译中提供这种语境的有效方式。用户在规划翻译策略时，可以将context参数专门用于短文本翻译场景，在长文本翻译中则无需额外使用。
常见问题FAQ
context参数和术语表有什么区别？
context参数用于为待翻译文本提供短时语境信息（如前后文），帮助处理多义词、性别和音译一致性问题。术语表则用于确保特定词汇（如品牌名、专业术语）始终按指定方式翻译，两者解决不同层面的翻译需求。context参数中的文本会被翻译或计费吗？
context参数提供的文本仅用于帮助翻译引擎理解待翻译内容的语境，其本身不会出现在翻译结果中。context参数可以用于指定翻译风格或语气吗？
context参数并非为指令设计，放入"用友好语气翻译"这类指令会产生不可预测的结果。风格和语气控制应使用custom_instructions参数。
