翻译记忆库Translation Memory

存储和管理历史翻译对,自动复用相似内容,减少重复翻译成本最高 60%。支持模糊匹配、精确匹配和上下文匹配,可导入导出 TMX 标准格式,与 CAT 工具无缝对接。在翻译 API 中传入 tm_id 即可自动查询记忆库,匹配度超过阈值时直接返回已有译文,无需重新翻译计费。Store and manage historical translation pairs. Auto-reuse similar content to reduce translation costs by up to 60%. Supports fuzzy, exact, and context matching. Import/export TMX standard format for seamless CAT tool integration. Pass tm_id to the translation API for automatic TM lookup; matches above threshold return existing translations without re-translation billing.

快速概览

Quick Overview

属性Attribute说明Description
记忆库端点TM EndpointPOST /v1/tm(创建)/ GET /v1/tm(列表)
条目端点Entry Endpoint/v1/tm/{tm_id}/entries
搜索端点Search EndpointGET /v1/tm/{tm_id}/search
导入/导出Import/Export/v1/tm/{tm_id}/import / /export(TMX 格式)
认证AuthenticationBearer Token(Authorization 请求头)Bearer Token in Authorization header
请求体Request Bodyapplication/json(JSON 格式)application/json (JSON format)
匹配类型Match Types精确匹配 / 模糊匹配 / 上下文匹配Exact / fuzzy / context matching
条目上限Entry Limit单库最多 100 万条,单次批量添加 ≤100 条Max 1M entries per TM; ≤100 per batch add
成本节省Cost Savings命中记忆库的文本不计费,最高节省 60% 翻译成本TM hits are not billed; up to 60% cost savings

认证

Authentication

所有 API 请求需在 HTTP Header 中携带 Access Token。

All API requests must include an Access Token in the HTTP Header.

Authorization: Bearer {access_token}

请求头

Request Headers

请求头Header必填Required说明Description
Authorizationrequired格式 Bearer {access_token},用于身份认证Format: Bearer {access_token}, used for authentication
Content-Typerequired固定为 application/json(文件导入除外)Must be application/json (except for file import)

创建记忆库

Create TM

POST/v1/tm
参数Parameter类型Type必填Required说明Description
namestringrequired记忆库名称,1~128 字符,同账号下需唯一Memory name, 1~128 chars, unique per account
source_langstringrequired源语言代码,如 en。详见语种列表Source language code, e.g. en. See Language List
target_langstringrequired目标语言代码,如 zhTarget language code, e.g. zh
descriptionstringoptional记忆库描述/备注,最长 500 字符TM description/notes, max 500 chars

创建响应示例

Create Response Example

{
  "tm_id": "tm_a1b2c3",
  "name": "Product Docs TM",
  "source_lang": "en",
  "target_lang": "zh",
  "description": "",
  "entry_count": 0,
  "created_at": "2026-07-21T10:00:00Z"
}

添加翻译条目

Add Entry

POST/v1/tm/{tm_id}/entries

向记忆库添加翻译条目,支持单条或批量添加(单次最多 100 条)。每条包含源文本和目标译文。

Add translation entries to a TM; supports single or batch (max 100 per request). Each entry contains source text and target translation.

条目参数

Entry Parameters

参数Parameter类型Type必填Required说明Description
sourcestringrequired源文本Source text
targetstringrequired目标译文Target translation
contextstringoptional上下文信息(前后文),用于上下文匹配提升精度Context info (surrounding text) for context matching
metadataobjectoptional自定义元数据,如 {"domain":"legal","author":"translator_A"}Custom metadata, e.g. {"domain":"legal","author":"translator_A"}

添加条目响应示例

Add Entry Response

{
  "tm_id": "tm_a1b2c3",
  "added": 1,
  "entry_ids": ["entry_001"]
}

查询相似

Search Similar

GET/v1/tm/{tm_id}/search

模糊搜索记忆库中与输入文本相似的翻译条目,返回匹配度和译文。翻译 API 内部调用此接口实现记忆复用。

Fuzzy search the TM for entries similar to the input text; returns match score and translations. The translation API calls this internally for TM reuse.

查询参数

Query Parameters

参数Parameter类型Type必填Required说明Description
textstringrequired待查询的源文本Source text to search
thresholdfloatoptional匹配阈值 0~1,默认 0.8。1.0 为精确匹配Match threshold 0~1, default 0.8. 1.0 for exact match
limitintegeroptional返回结果数量,1~20,默认 5Number of results, 1~20, default 5
contextstringoptional上下文文本,启用上下文匹配提升精度Context text for context matching

搜索响应示例

Search Response

{
  "results": [
    {
      "entry_id": "entry_001",
      "source": "Click to continue",
      "target": "点击继续",
      "score": 1.0,
      "match_type": "exact"
    },
    {
      "entry_id": "entry_042",
      "source": "Click to proceed",
      "target": "点击以继续",
      "score": 0.88,
      "match_type": "fuzzy"
    }
  ],
  "total": 2
}

列表与记忆库管理

List & Manage TMs

查询记忆库列表

List TMs

GET/v1/tm
curl -X GET "https://api.itranslator.cc/v1/tm?page=1&page_size=20" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "tms": [
    {
      "tm_id": "tm_a1b2c3",
      "name": "Product Docs TM",
      "source_lang": "en",
      "target_lang": "zh",
      "entry_count": 12580,
      "created_at": "2026-07-21T10:00:00Z"
    }
  ],
  "total": 3,
  "page": 1,
  "page_size": 20
}

更新记忆库信息

Update TM

PUT/v1/tm/{tm_id}
curl -X PUT https://api.itranslator.cc/v1/tm/tm_a1b2c3 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Product Docs TM v2", "description": "更新后的描述"}'

删除记忆库

Delete TM

DELETE/v1/tm/{tm_id}

删除记忆库及其所有条目,此操作不可撤销。

Delete a TM and all its entries. This action is irreversible.

curl -X DELETE https://api.itranslator.cc/v1/tm/tm_a1b2c3 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

导入与导出

Import & Export

支持 TMX(Translation Memory eXchange)标准格式导入导出,可与其他 CAT 工具(如 Trados、memoQ、OmegaT)无缝对接。

Supports TMX (Translation Memory eXchange) standard format import/export for seamless integration with CAT tools (Trados, memoQ, OmegaT).

导入 TMX 文件

Import TMX

POST/v1/tm/{tm_id}/import
curl -X POST https://api.itranslator.cc/v1/tm/tm_a1b2c3/import \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@translations.tmx"

导出 TMX 文件

Export TMX

GET/v1/tm/{tm_id}/export
curl -X GET https://api.itranslator.cc/v1/tm/tm_a1b2c3/export \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o export.tmx

请求示例

Request Examples

# 1. 创建记忆库
curl -X POST https://api.itranslator.cc/v1/tm \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Product Docs TM", "source_lang": "en", "target_lang": "zh"}'

# 2. 添加条目
curl -X POST https://api.itranslator.cc/v1/tm/tm_abc/entries \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"source": "Click to continue", "target": "点击继续"}]'

# 3. 搜索相似文本
curl "https://api.itranslator.cc/v1/tm/tm_abc/search?text=Click&threshold=0.75" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

在翻译中启用

Enable in Translation

在调用翻译 API 时传入 tm_id,系统会自动查询记忆库,匹配度 > 阈值时直接返回已有译文,无需重新翻译计费。命中记忆库的响应中会标注 tm_match 和匹配度。Pass tm_id to the translation API — the system auto-queries the TM and returns existing translations for matches above threshold, saving costs. Hits are marked with tm_match and match score in the response.

curl -X POST https://api.itranslator.cc/v1/translate \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Click to continue", "source_lang": "en", "target_lang": "zh",
       "tm_id": "tm_a1b2c3", "tm_threshold": 0.8}'

翻译响应(命中记忆库)

Translation Response (TM Hit)

{
  "translated_text": "点击继续",
  "source_lang": "en",
  "target_lang": "zh",
  "tm_match": true,
  "tm_score": 1.0,
  "tm_match_type": "exact",
  "billed": false
}
💡 匹配类型说明
  • 精确匹配(exact):score=1.0,源文本完全一致,直接复用译文,不计费
  • Exact match: score=1.0, identical source text; reuse directly, not billed
  • 模糊匹配(fuzzy):score ≥ 阈值但 < 1.0,源文本相似但不完全相同,返回参考译文,按比例计费
  • Fuzzy match: score ≥ threshold but < 1.0; similar but not identical; partial billing
  • 上下文匹配(context):结合前后文判断,减少歧义,准确率更高
  • Context match: Uses surrounding text to disambiguate; higher accuracy

匹配阈值参考

Threshold Reference

阈值Threshold匹配效果Effect推荐场景Recommended For
1.0仅精确匹配,零误差Exact match only, zero tolerance法律、医疗等高精度要求场景Legal, medical; high-precision scenarios
0.8~0.99模糊匹配,允许细微差异Fuzzy match, allows minor differences产品文档、用户手册(默认推荐)Product docs, manuals (default recommended)
0.6~0.79宽松匹配,命中率更高但需人工校对Loose match, higher hit rate but needs review初稿翻译、内部参考Draft translation, internal reference

错误码

Error Codes

HTTP Code错误码Error Code说明Description
2000成功Success
4001001参数错误,请检查必填参数和参数格式Invalid parameter; check required fields and format
4001019批量添加条目超过 100 条上限Batch entries exceed 100-item limit
4001020TMX 文件格式错误或已损坏Invalid or corrupted TMX file format
4001021记忆库条目语言与记忆库设置的语言对不匹配Entry language does not match the TM's language pair
4012001认证失败,Token 无效或已过期Authentication failed; invalid or expired token
4032003无权限访问该资源Access denied; insufficient permissions
4042004记忆库或条目不存在TM or entry not found
4091003数据冲突,如重复创建同名记忆库Data conflict (e.g. duplicate TM name)
4133001导入文件超出大小限制(最大 50MB)Import file exceeds size limit (max 50MB)
4223015记忆库条目数已达上限(100 万条)TM entry count reached limit (1M entries)
4294001请求频率超限,请稍后重试Rate limit exceeded; please retry later
4564002套餐配额已用尽,请升级或等待重置Plan quota exhausted; upgrade or wait for reset
5005001服务器内部错误,请重试或联系技术支持Internal server error; retry or contact support

最佳实践

Best Practices

  1. 按项目/语言对建立独立记忆库:不同项目或语言对应使用独立 TM,避免交叉污染,提升匹配精度。
  2. Separate TMs per Project/Language: Use independent TMs for different projects or language pairs to avoid cross-contamination and improve match accuracy.
  3. 合理设置匹配阈值:默认 0.8 适合大多数场景;高精度需求设为 1.0 仅精确匹配;初稿翻译可降至 0.6 提高命中率。
  4. Set Threshold Wisely: Default 0.8 fits most cases; 1.0 for exact-only; 0.6 for drafts to boost hit rate.
  5. 配合术语库使用:TM 复用历史译文,术语库确保术语一致,两者结合可显著提升翻译质量和一致性。
  6. Combine with Glossary: TM reuses past translations; glossary ensures term consistency. Together they significantly boost quality.
  7. 定期维护记忆库:清理低质量条目,导入新的高质量译文,保持记忆库时效性和准确性。
  8. Maintain Regularly: Clean low-quality entries; import new high-quality translations to keep the TM current and accurate.
  9. 添加上下文信息:为条目添加 context 字段,在歧义场景下显著提升匹配准确率。
  10. Add Context: Include context field for entries; significantly improves match accuracy in ambiguous scenarios.
  11. 利用 TMX 导入导出:从现有 CAT 工具导出 TMX 导入记忆库,或将记忆库导出迁移到其他平台。
  12. Use TMX Import/Export: Import TMX from existing CAT tools; or export to migrate to other platforms.

应用场景

Use Cases

场景Scenario推荐配置Recommended Config说明Notes
📖 产品文档迭代 Product Doc Iteration 阈值 0.8 + 术语库 Threshold 0.8 + glossary 版本更新时复用历史译文,大幅减少重复翻译量 Reuse past translations across versions; significantly reduce repeat work
⚖️ 法律合同翻译 Legal Contract 阈值 1.0 + 上下文匹配 Threshold 1.0 + context match 仅精确匹配,确保合同条款译文零误差 Exact match only; ensure zero-error contract clause translations
🎮 游戏本地化 Game Localization 阈值 0.8 + 多语言 TM Threshold 0.8 + multi-language TM 复用 UI 文本和对话译文,保持系列游戏风格一致 Reuse UI text and dialogue; maintain consistency across game series
🔬 技术文档 Technical Docs 阈值 0.85 + 术语库 Threshold 0.85 + glossary 复用技术描述译文,确保专业术语和表述统一 Reuse technical translations; ensure consistent terminology
🔄 CAT 工具迁移 CAT Tool Migration TMX 导入/导出 TMX import/export 从 Trados/memoQ 导入历史翻译库,或导出迁移 Import from Trados/memoQ; or export for migration
📊 批量翻译降本 Batch Cost Reduction 阈值 0.6 + 大容量 TM Threshold 0.6 + large TM 大批量内容翻译时最大化命中率,降低翻译成本 Maximize hit rate for bulk translation; reduce costs
使用说明
  • 所有管理类 API 均需使用 OAuth Token 鉴权。
  • All management APIs require OAuth Token authentication.
  • 批量操作请注意分页参数,单次请求建议不超过 100 条记录。
  • For batch operations, use pagination; limit to 100 records per request.
  • 数据变更操作无法撤销,请谨慎调用删除/更新接口。
  • Data mutations are irreversible; use caution with delete/update APIs.