词汇表管理 Glossary Management 创建和管理自定义术语库，确保品牌名称、专业术语、产品名等在翻译中保持一致。翻译时可关联词汇表 ID。 Create and manage custom glossaries to ensure brand names, technical terms, and product names are translated consistently. Associate with translations via glossary_id.
快速概览
Quick Overview
术语库 API 提供完整的 CRUD 操作，支持创建词汇表、批量导入术语条目、查询与删除。每条术语条目由源语言文本和目标语言文本组成，在翻译任务中通过 glossary_id 引用即可生效。每个账号最多创建 100 个词汇表，每个词汇表最多包含 10,000 条术语。
The Glossary API provides complete CRUD operations to create glossaries, bulk import entries, query, and delete. Each entry consists of a source text and a target text. Once a glossary is referenced via glossary_id in a translation request, terms are applied automatically. Each account can create up to 100 glossaries with up to 10,000 entries each.
认证方式 Authentication
所有术语库管理接口均需要在 HTTP 请求头中携带有效的 API Token 进行身份认证。请在 控制台 获取您的 Access Token。
All glossary management endpoints require a valid API Token in the HTTP request header for authentication. Obtain your Access Token from the Console .
Authorization: Bearer <YOUR_ACCESS_TOKEN>
请求头 Request Headers
Header Header 类型 Type 必填 Required 说明 Description
Authorizationstring required Bearer Token 认证信息 Bearer token authentication Content-Typestring required 请求体格式，固定为 application/json Request body format; fixed to application/json
创建词汇表 Create Glossary
POST /v1/glossary
参数 Parameter 类型 Type 必填 Required 说明 Description
name string required 词汇表名称 Glossary name source_lang string required 源语言代码 Source language code target_lang string required 目标语言代码 Target language code entries array required 术语条目列表，最少 1 条，最多一次 500 条 Array of entry objects; min 1, max 500 per request description string optional 词汇表描述，便于管理和区分 Description for management and identification case_sensitive boolean optional 是否大小写敏感匹配，默认 true Case-sensitive matching; default true
Entry 条目对象字段 Entry Object Fields
字段 Field 类型 Type 必填 Required 说明 Description
source string required 源语言术语文本，最长 200 字符 Source term text; max 200 characters target string required 目标语言术语文本，最长 200 字符 Target term text; max 200 characters note string optional 备注说明，如上下文或使用场景 Note or context for this entry pos string optional 词性标注，如 noun、verb、adj Part of speech tag, e.g. noun, verb, adj
响应字段 Response Fields
字段 Field 类型 Type 说明 Description
code integer 状态码，0 表示成功 Status code; 0 = success message string 操作结果描述信息 Result description message data.id string 词汇表唯一标识 ID Unique glossary identifier data.name string 词汇表名称 Glossary name data.source_lang string 源语言代码 Source language code data.target_lang string 目标语言代码 Target language code data.entry_count integer 当前术语条目数量 Current entry count data.created_at string 创建时间，ISO 8601 格式 Creation time in ISO 8601 format
请求示例 Request Examples
cURL
Python
JavaScript
Java
Go
curl -X POST https://api.itranslator.cc/v1/glossary \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "我的产品术语库",
"source_lang": "zh",
"target_lang": "en",
"case_sensitive": true,
"entries": [
{"source": "人工智能", "target": "AI", "note": "通用"},
{"source": "机器学习", "target": "Machine Learning", "pos": "noun"}
]
}' import requests
payload = {
"name": "我的产品术语库",
"source_lang": "zh",
"target_lang": "en",
"case_sensitive": True,
"entries": [
{"source": "人工智能", "target": "AI", "note": "通用"},
{"source": "机器学习", "target": "Machine Learning", "pos": "noun"}
]
}
resp = requests.post(
"https://api.itranslator.cc/v1/glossary",
headers={"Authorization": f"Bearer {token}"},
json=payload
)
print(resp.json()) const payload = {
name: "我的产品术语库",
source_lang: "zh",
target_lang: "en",
case_sensitive: true,
entries: [
{ source: "人工智能", target: "AI", note: "通用" },
{ source: "机器学习", target: "Machine Learning", pos: "noun" }
]
};
const resp = await fetch("https://api.itranslator.cc/v1/glossary", {
method: "POST",
headers: {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
});
console.log(await resp.json()); import com.google.gson.Gson;
import java.util.*;
Gson gson = new Gson();
Map<String, Object> payload = new HashMap<>();
payload.put("name", "我的产品术语库");
payload.put("source_lang", "zh");
payload.put("target_lang", "en");
payload.put("case_sensitive", true);
List<Map<String, String>> entries = new ArrayList<>();
Map<String, String> e1 = new HashMap<>();
e1.put("source", "人工智能"); e1.put("target", "AI"); e1.put("note", "通用");
entries.add(e1);
Map<String, String> e2 = new HashMap<>();
e2.put("source", "机器学习"); e2.put("target", "Machine Learning"); e2.put("pos", "noun");
entries.add(e2);
payload.put("entries", entries);
RequestBody body = RequestBody.create(
gson.toJson(payload), MediaType.parse("application/json"));
Request request = new Request.Builder()
.url("https://api.itranslator.cc/v1/glossary")
.header("Authorization", "Bearer " + token)
.post(body)
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string()); package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
payload := map[string]interface{}{
"name": "我的产品术语库",
"source_lang": "zh",
"target_lang": "en",
"case_sensitive": true,
"entries": []map[string]string{
{"source": "人工智能", "target": "AI", "note": "通用"},
{"source": "机器学习", "target": "Machine Learning", "pos": "noun"},
},
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST",
"https://api.itranslator.cc/v1/glossary",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
fmt.Println(resp.Status)
}
响应示例
Response Example
{
"code": 0,
"message": "success",
"data": {
"id": "gls_8a7b3c2d1e",
"name": "我的产品术语库",
"source_lang": "zh",
"target_lang": "en",
"entry_count": 2,
"created_at": "2026-07-22T10:30:00Z"
}
}
查询词汇表列表 List Glossaries
GET /v1/glossary
获取当前账号下所有词汇表列表，支持分页和筛选。
Retrieve all glossaries under the current account, with pagination and filtering support.
参数 Parameter 类型 Type 必填 Required 说明 Description
page integer optional 页码，从 1 开始，默认 1 Page number starting from 1; default 1 page_size integer optional 每页数量，默认 20，最大 100 Items per page; default 20, max 100 source_lang string optional 按源语言筛选 Filter by source language target_lang string optional 按目标语言筛选 Filter by target language keyword string optional 按名称关键词搜索 Search by glossary name keyword
cURL
Python
JavaScript
curl -X GET "https://api.itranslator.cc/v1/glossary?page=1&page_size=20&source_lang=zh" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" import requests
params = {"page": 1, "page_size": 20, "source_lang": "zh"}
resp = requests.get(
"https://api.itranslator.cc/v1/glossary",
headers={"Authorization": f"Bearer {token}"},
params=params
)
print(resp.json()) const params = new URLSearchParams({ page: 1, page_size: 20, source_lang: "zh" });
const resp = await fetch(
`https://api.itranslator.cc/v1/glossary?${params}`,
{ headers: { Authorization: `Bearer ${token}` } }
);
console.log(await resp.json());
响应示例
Response Example
{
"code": 0,
"message": "success",
"data": {
"total": 5,
"page": 1,
"page_size": 20,
"items": [
{
"id": "gls_8a7b3c2d1e",
"name": "我的产品术语库",
"source_lang": "zh",
"target_lang": "en",
"entry_count": 250,
"description": "产品文档专用术语",
"case_sensitive": true,
"created_at": "2026-07-20T08:00:00Z",
"updated_at": "2026-07-22T10:30:00Z"
}
]
}
}
获取词汇表详情 Get Glossary Details
GET /v1/glossary/{id}
获取指定词汇表的详细信息，包括所有术语条目。
Retrieve detailed information for a specific glossary, including all entries.
参数 Parameter 类型 Type 必填 Required 说明 Description
id string required 路径参数：词汇表 ID Path parameter: glossary ID page integer optional 条目分页页码，默认 1 Entry pagination page; default 1 page_size integer optional 每页条目数，默认 100，最大 500 Entries per page; default 100, max 500
cURL
Python
JavaScript
curl -X GET "https://api.itranslator.cc/v1/glossary/gls_8a7b3c2d1e?page=1&page_size=100" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" import requests
glossary_id = "gls_8a7b3c2d1e"
resp = requests.get(
f"https://api.itranslator.cc/v1/glossary/{glossary_id}",
headers={"Authorization": f"Bearer {token}"},
params={"page": 1, "page_size": 100}
)
print(resp.json()) const glossaryId = "gls_8a7b3c2d1e";
const resp = await fetch(
`https://api.itranslator.cc/v1/glossary/${glossaryId}?page=1&page_size=100`,
{ headers: { Authorization: `Bearer ${token}` } }
);
console.log(await resp.json());
响应示例
Response Example
{
"code": 0,
"message": "success",
"data": {
"id": "gls_8a7b3c2d1e",
"name": "我的产品术语库",
"source_lang": "zh",
"target_lang": "en",
"description": "产品文档专用术语",
"case_sensitive": true,
"entry_count": 250,
"entries": [
{
"id": "ent_001",
"source": "人工智能",
"target": "AI",
"note": "通用",
"pos": "noun",
"created_at": "2026-07-20T08:05:00Z"
},
{
"id": "ent_002",
"source": "机器学习",
"target": "Machine Learning",
"pos": "noun",
"created_at": "2026-07-20T08:05:00Z"
}
],
"created_at": "2026-07-20T08:00:00Z",
"updated_at": "2026-07-22T10:30:00Z"
}
}
添加术语条目 Add Entries
POST /v1/glossary/{id}/entries
向指定词汇表批量添加术语条目。如果 source 已存在，默认会覆盖 target 值。
Batch add entries to a specified glossary. If a source term already exists, the target value will be overwritten by default.
参数 Parameter 类型 Type 必填 Required 说明 Description
id string required 路径参数：词汇表 ID Path parameter: glossary ID entries array required 术语条目列表，一次最多 500 条 Entry array; max 500 per request overwrite boolean optional 遇到重复 source 时是否覆盖，默认 true Whether to overwrite duplicate sources; default true
cURL
Python
JavaScript
curl -X POST https://api.itranslator.cc/v1/glossary/gls_8a7b3c2d1e/entries \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"entries": [
{"source": "深度学习", "target": "Deep Learning", "pos": "noun"},
{"source": "自然语言处理", "target": "NLP", "note": "缩写"}
],
"overwrite": true
}' import requests
glossary_id = "gls_8a7b3c2d1e"
payload = {
"entries": [
{"source": "深度学习", "target": "Deep Learning", "pos": "noun"},
{"source": "自然语言处理", "target": "NLP", "note": "缩写"}
],
"overwrite": True
}
resp = requests.post(
f"https://api.itranslator.cc/v1/glossary/{glossary_id}/entries",
headers={"Authorization": f"Bearer {token}"},
json=payload
)
print(resp.json()) const glossaryId = "gls_8a7b3c2d1e";
const payload = {
entries: [
{ source: "深度学习", target: "Deep Learning", pos: "noun" },
{ source: "自然语言处理", target: "NLP", note: "缩写" }
],
overwrite: true
};
const resp = await fetch(
`https://api.itranslator.cc/v1/glossary/${glossaryId}/entries`,
{
method: "POST",
headers: {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json"
},
body: JSON.stringify(payload)
}
);
console.log(await resp.json());
响应示例
Response Example
{
"code": 0,
"message": "success",
"data": {
"added": 2,
"updated": 0,
"skipped": 0,
"entry_count": 252
}
}
删除术语条目 Delete Entry
DELETE /v1/glossary/{id}/entries/{entry_id}
删除词汇表中的单条术语条目。
Delete a single entry from a glossary.
cURL
Python
JavaScript
curl -X DELETE https://api.itranslator.cc/v1/glossary/gls_8a7b3c2d1e/entries/ent_001 \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" import requests
glossary_id = "gls_8a7b3c2d1e"
entry_id = "ent_001"
resp = requests.delete(
f"https://api.itranslator.cc/v1/glossary/{glossary_id}/entries/{entry_id}",
headers={"Authorization": f"Bearer {token}"}
)
print(resp.json()) const glossaryId = "gls_8a7b3c2d1e";
const entryId = "ent_001";
const resp = await fetch(
`https://api.itranslator.cc/v1/glossary/${glossaryId}/entries/${entryId}`,
{
method: "DELETE",
headers: { Authorization: `Bearer ${token}` }
}
);
console.log(await resp.json());
响应示例
Response Example
{
"code": 0,
"message": "success",
"data": {
"deleted_entry_id": "ent_001",
"entry_count": 251
}
}
删除词汇表 Delete Glossary
DELETE /v1/glossary/{id}
注意：此操作不可逆！
Warning: This operation is irreversible!
删除整个词汇表及其所有术语条目。已关联该词汇表的翻译任务之后将不再应用这些术语。
Deletes the entire glossary and all its entries. Translation tasks that reference this glossary will no longer apply these terms.
cURL
Python
JavaScript
curl -X DELETE https://api.itranslator.cc/v1/glossary/gls_8a7b3c2d1e \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" import requests
glossary_id = "gls_8a7b3c2d1e"
resp = requests.delete(
f"https://api.itranslator.cc/v1/glossary/{glossary_id}",
headers={"Authorization": f"Bearer {token}"}
)
print(resp.json()) const glossaryId = "gls_8a7b3c2d1e";
const resp = await fetch(
`https://api.itranslator.cc/v1/glossary/${glossaryId}`,
{
method: "DELETE",
headers: { Authorization: `Bearer ${token}` }
}
);
console.log(await resp.json());
响应示例
Response Example
{
"code": 0,
"message": "success",
"data": {
"deleted_glossary_id": "gls_8a7b3c2d1e",
"deleted_entry_count": 252
}
}
使用限制 Limits
项目 Item 上限 Limit 说明 Notes
每账号词汇表数 Glossaries per account 100 超出后需删除旧词汇表 Delete old glossaries if exceeded 每词汇表条目数 Entries per glossary 10,000 建议针对不同领域拆分词汇表 Consider splitting by domain 源/目标文本长度 Source/target text length 200 字符 chars 适合单词、短语和短句 Suitable for words, phrases, and short sentences 单次批量添加条目 Entries per batch add 500 超过需分多次请求 Split into multiple requests if exceeded 请求频率 Rate limit 60 次/分钟 req/min 按账号计算 Per account
错误码 Error Codes
HTTP Code 错误码 Error Code 说明 Description
200 0成功 Success 400 1001参数错误，请检查必填参数和参数格式 Invalid parameter; check required fields and format 400 1002条目格式错误，source 或 target 为空 Entry format error; empty source or target 409 1003数据冲突，同语言对下已存在同名词汇表 Data conflict; glossary with same name exists for this language pair 400 1004词汇表条目数已达上限 Glossary entry limit reached 400 1005词汇表数量已达账号上限 Account glossary count limit reached 400 1006源/目标文本超出长度限制 Source or target text exceeds length limit 401 2001认证失败，Token 无效或已过期 Authentication failed; invalid or expired token 403 2003无权限访问该资源 Access denied; insufficient permissions 404 2004资源不存在（词汇表或条目不存在） Resource not found (glossary or entry) 429 4001请求频率超限，请稍后重试 Rate limit exceeded; please retry later 500 5001服务器内部错误，请重试或联系技术支持 Internal server error; retry or contact support
最佳实践 Best Practices
建议 Suggestion 说明 Description
按领域拆分词汇表 Split glossaries by domain 为不同产品线、功能模块或内容类型创建独立词汇表，便于维护和复用 Create separate glossaries for different products, modules, or content types for easier maintenance and reuse 使用 note 字段记录上下文 Use note field for context 为多义词或特定场景术语添加使用说明，方便团队成员协作 Add usage notes for polysemous or context-specific terms to facilitate team collaboration 标记词性提升匹配精度 Tag POS for better matching 标注 pos 字段有助于避免同形异义词的误替换 Using the pos field helps avoid incorrect substitution of homographs 批量导入时分批处理 Batch import in chunks 大量条目建议每次 200-500 条分批调用，避免单次请求超时 For large imports, send 200-500 entries per batch to avoid request timeouts 翻译前验证词汇表关联 Verify glossary before translation 翻译前通过 Get Glossary 确认条目数量，确保术语库已正确配置 Confirm entry count via Get Glossary before translation to ensure correct configuration 定期清理过期术语 Clean up obsolete terms 定期审查并删除不再使用的术语条目，避免词汇表臃肿影响匹配性能 Regularly review and delete unused entries to prevent glossary bloat and maintain matching performance
典型用例 Use Cases
场景 Scenario 最佳方案 Approach
品牌名称统一翻译 Brand name consistency 创建品牌术语词汇表，将公司名、产品名、口号等条目统一管理，翻译时关联即可保证品牌一致性 Create a brand glossary with company names, product names, and slogans; link it in translation to ensure brand consistency 行业专属术语翻译 Industry-specific terms 按行业（医疗、法律、金融、IT）分别创建词汇表，为高频专业术语维护标准译法 Create domain-specific glossaries (medical, legal, finance, IT) with standardized translations for high-frequency terminology UI/UX 界面本地化 UI/UX localization 为界面字符串创建词汇表，固定按钮、菜单、提示中的常见 UI 元素的翻译 Create a UI glossary to fix translations for common interface elements like buttons, menus, and tooltips 多语言文档同步 Multi-language documentation 为文档中重复出现的技术缩写和概念创建词汇表，翻译时自动应用，减少人工校对工作 Create a glossary for recurring technical abbreviations and concepts in documentation; apply automatically during translation to reduce manual review 术语库与TM协同使用 Glossary + TM synergy 将术语库与翻译记忆库 配合使用：术语库保证关键术语准确，翻译记忆库保证句段整体一致性 Use glossary alongside Translation Memory : the glossary ensures key term accuracy, while TM ensures overall segment consistency API 批量管理自动化 Automated batch management 通过 API 将术语库管理集成到 CI/CD 流程中，代码仓库中维护术语文件，发版时自动同步到 TranslatePro Integrate glossary management into CI/CD pipelines via API; maintain term files in code repositories and auto-sync to TranslatePro on release
iTranslator