产品文档

文本翻译

更新于 2026-09-04

中文与传统蒙古文、西里尔蒙古文之间的高质量机器翻译,支持单条与批量调用。

能力与场景

文本翻译提供中文、传统蒙古文、西里尔蒙古文等语向的高质量互译,是平台使用最广的基础能力。典型场景:即时通讯消息翻译、新闻稿件蒙汉双语生产、电商商品信息本地化、政务公文辅助翻译。支持自动语种检测,可结合术语库统一专有名词译法。

本产品提供 fast / standard / pro 三个档位(请求参数 mode),底层由不同规格的翻译模型驱动,翻译质量与单价逐级提升,可按业务对质量与成本的取舍逐次调用选择,单条与批量接口均支持。

端点列表

方法路径说明
POST/v1/translate/text单条文本翻译
POST/v1/translate/batch批量文本翻译(一次提交多条)

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

调用要点

  • mode 决定档位与单价:fast(最快最省)、standard(默认,均衡)、pro(质量最高,含蒙古文润色)。
  • 单条文本有长度上限,超长文本请分段或改用文档翻译;批量接口单次提交条数与总字符数也有上限,超限返回 invalid_request
  • 源语言自动检测,无需传参;目标语言代码见下方「支持语种」。
  • 需要统一术语译法时,先在术语库产品中创建词表,再在请求中引用术语库 ID。
  • 计费字符数按源文本字符数统计(含标点与空格),乘以所选档位单价;各档免费额度独立计数。

支持语种

  • 源语言无需传参,由引擎自动检测(列表内语种之间可互译)。
  • 传统蒙古文(mw)译文以 Unicode 国标编码输出;如需蒙科立编码请再调用编码转换接口。

目标语言(参数 targetLang):

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

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

计费

按字符计费,单价随所选档位不同(请求参数 mode):

档位mode说明
快速档fast轻量模型驱动,响应最快、单价最低,适合海量内容、实时场景与对成本敏感的批量处理。
标准档standard标准模型驱动,质量与成本均衡,覆盖绝大多数通用翻译场景(默认档)。
专业档pro旗舰模型驱动并附加译文精修,适合出版、合同、公文等对译文质量要求最高的场景。
  • 不传 mode 时按标准档计费。
  • 每档的免费额度独立计数、互不挤占,均于月初重置,优先于余额抵扣。
  • 仅对成功的调用计费;失败调用不扣费。
  • 各档实时单价与免费额度见本页下方「当前价格」(后台调价即时生效),总规则见「计费与免费额度」。

当前价格

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

档位mode计费单位单价每月免费额度
快速档fast按字符计费¥0.4 / 千字符2 万 字符 / 月
标准档默认standard按字符计费¥0.6 / 千字符5,000 字符 / 月
专业档pro按字符计费¥0.8 / 千字符2,000 字符 / 月

API 参考

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

文本翻译

POST/v1/translate/text

单条文本翻译,源语言自动检测。支持 fast / standard / pro 三档模式(底层模型规格与单价逐级提升)与个人术语库注入。按输入字符数 × 所选档位单价计费。

请求参数application/json

参数类型说明
text必填
string待翻译文本(最长 10000 字符),源语言自动检测
示例:今天天气真好
targetLang必填
string目标语言代码(不在列表内返回 unsupported_language)
可选值:zhenmwxle_mwesfrdejakoruptarhiidyuelaipakkboug
示例:mw
mode可选
string翻译档位(决定底层模型与计费单价,三档单价见定价页):fast=快速档(最快最省),standard=标准档(默认,质量成本均衡),pro=专业档(旗舰模型 + 蒙古文润色,质量最高)。
可选值:faststandardpro
默认值:standard
示例:standard
glossaryId可选
string术语库 ID(须属于当前账号且目标语言与 targetLang 一致);命中的术语将注入翻译约束译文用词
示例:clv3xk2m40001abcd1234

响应示例200 · application/json

200 响应
{
  "text": "ᠥᠨᠥᠳᠥᠷ ᠲᠡᠩᠷᠢ ᠰᠠᠶᠢᠬᠠᠨ ᠪᠠᠶᠢᠨ᠎ᠠ",
  "sourceLang": "zh"
}

代码示例

curl -X POST "https://cloud.heimori.cn/v1/translate/text" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "text": "今天天气真好",
  "targetLang": "mw",
  "mode": "standard",
  "glossaryId": "clv3xk2m40001abcd1234"
}'

批量文本翻译

POST/v1/translate/batch

一次请求翻译多条文本(文档场景批量链路),译文顺序与输入一一对应。最多 100 条、单条 5000 字、总量 50000 字。支持与单条翻译相同的 fast / standard / pro 三档,按总输入字符数 × 所选档位单价计费。

请求参数application/json

参数类型说明
texts必填
array<string>待翻译文本数组(最多 100 条,单条最长 5000 字符,总量不超 50000 字符)。空字符串条目原样返回空串,顺序与输入一一对应
示例:["第一段","第二段"]
targetLang必填
string目标语言代码
可选值:zhenmwxle_mwesfrdejakoruptarhiidyuelaipakkboug
示例:zh
mode可选
string翻译档位,与 translateText 一致(fast / standard / pro);计费按所选档位单价 × 总输入字符数
可选值:faststandardpro
默认值:standard
示例:standard
glossaryId可选
string术语库 ID(同 translateText)
示例:clv3xk2m40001abcd1234

响应示例200 · application/json

200 响应
{
  "translations": [
    "ᠨᠢᠭᠡᠳᠦᠭᠡᠷ ᠬᠡᠰᠡᠭ",
    "ᠬᠣᠶᠠᠳᠤᠭᠠᠷ ᠬᠡᠰᠡᠭ"
  ]
}

代码示例

curl -X POST "https://cloud.heimori.cn/v1/translate/batch" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "texts": [
    "第一段",
    "第二段"
  ],
  "targetLang": "zh",
  "mode": "standard",
  "glossaryId": "clv3xk2m40001abcd1234"
}'