要为腾讯混元翻译服务实现专业术语的统一翻译，仅仅创建一个术语库是不够的——必须将具体的词条添加到库中。否则，即便调用了ChatTranslations接口，系统也不会自动替换术语。简单来说，术语库就像一个空容器，只有填入内容，它才能真正发挥作用。

说实话，不少人在这个环节栽过跟头：术语库建好了，名称也起好了，但翻译结果中专业词汇依然混乱。原因很简单——没有给术语库添加具体词条。因此，接下来的步骤一个都不能少。

确认术语库已创建并获取ID

登录腾讯云控制台，进入混元大模型服务下的术语管理页面，选中目标术语库，点击右侧的“详情”按钮。在弹窗顶部，复制【GlossaryId】字段值——其格式类似gls-abc123xyz。这个ID是后续所有操作的关键参数，术语库名称仅供人查看，系统内部只识别这个ID。如果未创建术语库就直接调用添加接口，系统会返回ResourceNotFound错误，这个坑不少新手都踩过。

使用CreateGlossaryEntry接口添加单个词条

方法一：通过API Explorer在线调试（推荐新手使用）

① 打开腾讯云API Explorer，搜索CreateGlossaryEntry接口；
② 在请求参数区域填写：GlossaryId（粘贴上一步复制的ID）、SourceTerm（源语言原文，例如GPU）、TargetTerm（目标语言译文，例如图形处理器）、LanguagePair（语言对，例如zh-en）；
③ 点击“发送请求”，成功返回EntryId即表示词条已成功入库。

注意：如果SourceTerm中包含空格或特殊符号，需要先进行URL编码再传入，否则接口会报InvalidParameter错误。这个细节容易被忽略，但一旦触发就会导致操作卡住。

批量导入词条（CSV格式）

方法二：调用CreateGlossaryEntry批量提交

准备一个CSV文件，首行是字段名：source_term,target_term,language_pair。后续每行对应一个词条，例如：

SSD,固态硬盘,zh-en
API密钥,API key,en-zh

将文件内容读取为字符串，拼入JSON Body的Entries数组，每个元素的结构与单条请求一致。一次最多提交50条，超出则需要分批操作。这一步操作起来其实很简单，直接把文件内容填入即可，但注意不要超过数量上限。

验证词条是否生效

最后一步，调用ChatTranslations接口，设置GlossaryId参数，然后发送一句包含源术语的测试文本。例如输入Our new SSD supports PCIe 5.0.，正确响应中SSD应被替换为固态硬盘，而不是默认的固态驱动器。

如果未替换，请先检查LanguagePair是否与翻译请求中的Source/Target完全一致——注意大小写敏感。这个检查点往往容易被忽视，但却是最常见的翻车原因。