产品文档
图片翻译
更新于 2026-09-04
对图片中的蒙古文/中文文字进行 OCR 识别并翻译,一次调用完成识别与翻译。
能力与场景
图片翻译在一次调用内完成 OCR 识别与翻译,对传统蒙古文竖排印刷体做过专项优化。典型场景:拍照翻译、证照与档案数字化、课本习题辅助阅读。返回结果同时包含识别原文与译文,也可只做识别不翻译。
本产品提供 fast / standard / pro 三个档位(请求参数 mode),识别与翻译由不同规格的多模态模型驱动,识别准确率、译文质量与单价逐级提升;仅识别(ocrOnly=true)同样按所选档位计费。
端点列表
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/translate/image | 图片 OCR + 翻译(JSON 提交 base64 图片) |
每个端点的请求参数、响应结构与可运行代码示例见本页下方「API 参考」(随接口定义自动生成,始终与线上一致)。
调用要点
- 以 JSON 提交:
image字段传 base64 字符串或 dataURL(data:image/png;base64,...),支持 JPG/PNG/GIF/WebP,解码后不超过 10MB。 mode决定档位与单价:fast(最快最省)、standard(默认,均衡)、pro(旗舰模型,识别与译文质量最高)。- 拍摄件请尽量保证文字清晰、光照均匀;倾斜或弯曲页面会显著影响识别率。
- 按图片张数计费,一次调用一张图片计一次费,乘以所选档位单价;识别不到文字的调用同样占用额度,各档免费额度独立计数。
支持语种
- OCR 可识别图片中的中文、传统蒙古文、西里尔蒙古文与拉丁字母文字,无需指定源语言。
ocrOnly=true时只识别不翻译,可不传 targetLang。
目标语言(参数 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.1 / 张 | 10 张 / 月 |
| 标准档默认 | standard | 按张计费 | ¥0.2 / 张 | 5 张 / 月 |
| 专业档 | pro | 按张计费 | ¥0.3 / 张 | 5 张 / 月 |
API 参考
本产品共 1 个接口,以下内容随接口定义自动生成。 需要跨产品查找接口时可前往接口索引。
图片翻译 / OCR
POST
/v1/translate/image识别图片中的文字(中文/西里尔/拉丁/传统蒙古文),可选翻译到目标语言。ocrOnly=true 时仅返回识别原文。图片 base64 解码后不超过 10MB。按张计费(1 张/次)。
请求参数application/json
| 参数 | 类型 | 说明 |
|---|---|---|
image必填 | string | 图片内容:base64 字符串或 dataURL(data:image/png;base64,...),解码后不超过 10MB,支持 jpeg/png/gif/webp 示例: data:image/png;base64,iVBORw0KGgoAAAANSUhEUg... |
targetLang可选 | string | 目标语言代码(ocrOnly=false 时必填) 可选值: zhenmwxle_mwesfrdejakoruptarhiidyuelaipakkboug示例: zh |
ocrOnly可选 | boolean | 仅识别不翻译:true 时只返回 OCR 原文 默认值: false示例: false |
mode可选 | string | 翻译档位(决定识别/翻译所用模型与计费单价,三档单价见定价页):fast=快速档(最快最省),standard=标准档(默认,质量成本均衡),pro=专业档(旗舰模型,识别与译文质量最高)。ocrOnly=true 时同样按所选档位计费 可选值: faststandardpro默认值: standard示例: standard |
响应示例200 · application/json
200 响应
{
"text": "ᠮᠣᠩᠭᠣᠯ ᠪᠢᠴᠢᠭ",
"translation": "蒙古文"
}代码示例
curl -X POST "https://cloud.heimori.cn/v1/translate/image" \
-H "Authorization: Bearer sk-heimori-..." \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
"targetLang": "zh",
"ocrOnly": false,
"mode": "standard"
}'