产品文档

术语库

更新于 2026-09-04

自定义术语词表管理，翻译时强制干预专有名词译法，免费使用。

能力与场景

术语库用于在翻译中强制统一专有名词译法：先创建词表并录入源词-译词对，再在文本/文档/网页翻译请求中引用词表 ID，引擎会按词表干预译文。典型场景：机构名与人名统一、行业术语规范、品牌名保护。

端点列表

方法路径说明
GET/v1/glossaries列出术语库
POST/v1/glossaries创建术语库
PATCH/v1/glossaries/{id}更新术语库（名称/描述/语向/启用状态）
DELETE/v1/glossaries/{id}删除术语库
GET/v1/glossaries/{id}/terms术语列表（分页 + 搜索）
POST/v1/glossaries/{id}/terms添加术语（同原文幂等更新译法）
PATCH/v1/glossaries/{id}/terms/{termId}更新术语（原文/译文/备注）
DELETE/v1/glossaries/{id}/terms/{termId}删除术语

每个端点的请求参数、响应结构与可运行代码示例见本页下方「API 参考」（随接口定义自动生成，始终与线上一致）。

调用要点

  • 术语库管理接口免费；库数量与词表条数有上限，超限返回 invalid_request。
  • 库与术语均支持 PATCH 局部更新：只传要修改的字段，未传字段保持不变。
  • 术语匹配区分大小写与词形，蒙古文词条建议录入常见变体。
  • 词表更新后对后续翻译请求即时生效（缓存最长 60 秒）。
  • 也可在控制台「术语库」产品页中可视化管理库与术语，无需编写代码。

支持语种

  • 术语库按「源语言 → 目标语言」建库；翻译请求引用时，术语库的目标语言必须与请求的 targetLang 一致。
  • sourceLang 缺省为 zh；targetLang=zh 时缺省为 mw。

源语言 / 目标语言（参数 sourceLang / targetLang）：

代码语种说明
zh中文简体中文
mw传统蒙古文回鹘式蒙古文（竖排），Unicode 国标编码
xle_mw西里尔蒙古文蒙古国通用的西里尔字母书写
en英语—
ru俄语—
es西班牙语—
fr法语—
de德语—
ja日语—
ko韩语—
pt葡萄牙语—
ar阿拉伯语—
hi印地语—
id印尼语—
yue粤语繁体书写
kk哈萨克语—
bo藏语—
ug维吾尔语—

完整代码表与各产品对照见「语种与语言代码」。

计费

术语库管理接口免费使用，不产生费用；术语干预随所配合的翻译产品按其规则计费。

当前价格

以下为实时生效价，与定价页同源；调价后此处立即同步。仅对成功调用计费，免费额度优先抵扣。

计费单位单价每月免费额度
按次计费¥0 / 次—

API 参考

本产品共 8 个接口，以下内容随接口定义自动生成。 需要跨产品查找接口时可前往接口索引。

术语库列表

GET/v1/glossaries

返回当前账号的全部术语库（含条数统计）。

请求参数

无请求参数

响应示例200 · application/json

200 响应
{
  "items": [
    {
      "id": "clv3xk2m40001abcd1234",
      "name": "法律术语库",
      "description": "合同与诉讼文书常用术语",
      "sourceLang": "zh",
      "targetLang": "mw",
      "enabled": true,
      "termCount": 128,
      "createdAt": "2026-07-01T08:00:00.000Z",
      "updatedAt": "2026-07-01T08:00:00.000Z"
    }
  ]
}

代码示例

curl -X GET "https://cloud.heimori.cn/v1/glossaries" \
  -H "Authorization: Bearer sk-heimori-..."

创建术语库

POST/v1/glossaries

创建术语库。sourceLang 缺省时默认 zh（targetLang=zh 时默认 mw）。库数量上限随账号会员档位，超限返回 invalid_request。

请求参数application/json

参数类型说明
name必填
string术语库名称（1~100 字符）
示例：法律术语库
targetLang必填
string目标语言（术语译文的语言，翻译接口按 targetLang 匹配注入）
可选值：zhmwxle_mwenruesfrdejakoptarhiidyuekkboug
示例：mw
sourceLang可选
string源语言（术语原文的语言）。缺省时默认 zh；targetLang=zh 时默认 mw。源语言与目标语言不能相同
可选值：zhmwxle_mwenruesfrdejakoptarhiidyuekkboug
示例：zh
description可选
string术语库描述（最长 300 字符）
示例：合同与诉讼文书常用术语

响应示例200 · application/json

200 响应
{
  "glossary": {
    "id": "clv3xk2m40001abcd1234",
    "name": "法律术语库",
    "description": "合同与诉讼文书常用术语",
    "sourceLang": "zh",
    "targetLang": "mw",
    "enabled": true,
    "termCount": 128,
    "createdAt": "2026-07-01T08:00:00.000Z",
    "updatedAt": "2026-07-01T08:00:00.000Z"
  }
}

代码示例

curl -X POST "https://cloud.heimori.cn/v1/glossaries" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "法律术语库",
  "targetLang": "mw",
  "sourceLang": "zh",
  "description": "合同与诉讼文书常用术语"
}'

更新术语库

PATCH/v1/glossaries/{id}

更新术语库的名称、描述、语言方向或启用状态（字段均可选，仅更新传入字段）。语言方向变更后按新方向匹配注入，源语言与目标语言不能相同。

请求参数application/json

参数类型说明
idpath必填
string术语库 ID
name可选
string术语库名称（1~100 字符）
示例：法律术语库（2026 修订）
description可选
string术语库描述（最长 300 字符，传空字符串清空）
示例：合同与诉讼文书常用术语
sourceLang可选
string源语言（与 targetLang 不能相同）
可选值：zhmwxle_mwenruesfrdejakoptarhiidyuekkboug
示例：zh
targetLang可选
string目标语言（与 sourceLang 不能相同）
可选值：zhmwxle_mwenruesfrdejakoptarhiidyuekkboug
示例：mw
enabled可选
boolean是否启用（false 后翻译接口不再注入该库术语）
示例：true

响应示例200 · application/json

200 响应
{
  "glossary": {
    "id": "clv3xk2m40001abcd1234",
    "name": "法律术语库",
    "description": "合同与诉讼文书常用术语",
    "sourceLang": "zh",
    "targetLang": "mw",
    "enabled": true,
    "termCount": 128,
    "createdAt": "2026-07-01T08:00:00.000Z",
    "updatedAt": "2026-07-01T08:00:00.000Z"
  }
}

代码示例

curl -X PATCH "https://cloud.heimori.cn/v1/glossaries/<id>" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "法律术语库（2026 修订）",
  "description": "合同与诉讼文书常用术语",
  "sourceLang": "zh",
  "targetLang": "mw",
  "enabled": true
}'

删除术语库

DELETE/v1/glossaries/{id}

删除术语库及其全部术语条目。

请求参数

参数类型说明
idpath必填
string术语库 ID

响应示例200 · application/json

200 响应
{
  "success": true
}

代码示例

curl -X DELETE "https://cloud.heimori.cn/v1/glossaries/<id>" \
  -H "Authorization: Bearer sk-heimori-..."

术语列表

GET/v1/glossaries/{id}/terms

分页返回术语库内的术语条目，支持关键字搜索。

请求参数

参数类型说明
idpath必填
string术语库 ID
pagequery可选
number页码（默认 1）
默认值：1
示例：1
limitquery可选
number每页条数（默认 100，最大 500）
默认值：100
示例：100
searchquery可选
string按原文/译文/备注模糊搜索
示例：不可抗力

响应示例200 · application/json

200 响应
{
  "items": [
    {
      "id": "clv3xk2m40002abcd5678",
      "source": "不可抗力",
      "target": "ᠳᠠᠪᠠᠭᠳᠠᠰᠢ ᠦᠭᠡᠢ ᠬᠦᠴᠦᠨ",
      "note": "民法典第 180 条",
      "createdAt": "2026-07-01T08:00:00.000Z",
      "updatedAt": "2026-07-01T08:00:00.000Z"
    }
  ],
  "total": 128
}

代码示例

curl -X GET "https://cloud.heimori.cn/v1/glossaries/<id>/terms" \
  -H "Authorization: Bearer sk-heimori-..."

添加术语

POST/v1/glossaries/{id}/terms

向术语库添加术语（同库同原文幂等：重复添加更新译法）。条目数上限随账号会员档位，超限返回 invalid_request。

请求参数application/json

参数类型说明
idpath必填
string术语库 ID
source必填
string术语原文（1~100 字符，同库同原文重复添加时更新译法）
示例：不可抗力
target必填
string术语译文（1~300 字符）
示例：ᠳᠠᠪᠠᠭᠳᠠᠰᠢ ᠦᠭᠡᠢ ᠬᠦᠴᠦᠨ
note可选
string备注（最长 200 字符）
示例：民法典第 180 条

响应示例200 · application/json

200 响应
{
  "term": {
    "id": "clv3xk2m40002abcd5678",
    "source": "不可抗力",
    "target": "ᠳᠠᠪᠠᠭᠳᠠᠰᠢ ᠦᠭᠡᠢ ᠬᠦᠴᠦᠨ",
    "note": "民法典第 180 条",
    "createdAt": "2026-07-01T08:00:00.000Z",
    "updatedAt": "2026-07-01T08:00:00.000Z"
  }
}

代码示例

curl -X POST "https://cloud.heimori.cn/v1/glossaries/<id>/terms" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "source": "不可抗力",
  "target": "ᠳᠠᠪᠠᠭᠳᠠᠰᠢ ᠦᠭᠡᠢ ᠬᠦᠴᠦᠨ",
  "note": "民法典第 180 条"
}'

更新术语

PATCH/v1/glossaries/{id}/terms/{termId}

更新指定术语的原文、译文或备注（字段均可选，仅更新传入字段）。原文改为库内已存在的术语时返回 invalid_request。

请求参数application/json

参数类型说明
idpath必填
string术语库 ID
termIdpath必填
string术语 ID
source可选
string术语原文（1~100 字符；改为库内已存在的原文时返回 invalid_request）
示例：不可抗力
target可选
string术语译文（1~300 字符）
示例：ᠳᠠᠪᠠᠭᠳᠠᠰᠢ ᠦᠭᠡᠢ ᠬᠦᠴᠦᠨ
note可选
string备注（最长 200 字符，传空字符串清空）
示例：民法典第 180 条

响应示例200 · application/json

200 响应
{
  "term": {
    "id": "clv3xk2m40002abcd5678",
    "source": "不可抗力",
    "target": "ᠳᠠᠪᠠᠭᠳᠠᠰᠢ ᠦᠭᠡᠢ ᠬᠦᠴᠦᠨ",
    "note": "民法典第 180 条",
    "createdAt": "2026-07-01T08:00:00.000Z",
    "updatedAt": "2026-07-01T08:00:00.000Z"
  }
}

代码示例

curl -X PATCH "https://cloud.heimori.cn/v1/glossaries/<id>/terms/<termId>" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "source": "不可抗力",
  "target": "ᠳᠠᠪᠠᠭᠳᠠᠰᠢ ᠦᠭᠡᠢ ᠬᠦᠴᠦᠨ",
  "note": "民法典第 180 条"
}'

删除术语

DELETE/v1/glossaries/{id}/terms/{termId}

删除术语库中的指定术语条目。

请求参数

参数类型说明
idpath必填
string术语库 ID
termIdpath必填
string术语 ID

响应示例200 · application/json

200 响应
{
  "success": true
}

代码示例

curl -X DELETE "https://cloud.heimori.cn/v1/glossaries/<id>/terms/<termId>" \
  -H "Authorization: Bearer sk-heimori-..."