产品文档

图片翻译

更新于 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"
}'