产品文档
文本翻译
更新于 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"
}'