网页翻译

更新于 2026-09-04

输入网页地址或 HTML，输出结构不变的整页译文，适合站点本地化。

能力与场景

网页翻译保留 HTML 结构、仅翻译文本节点，输出可直接渲染的整页译文，并支持传统蒙古文竖排形态。典型场景：新闻站点蒙文版镜像、政务公开页面双语化、浏览器整页翻译工具。

端点列表

方法	路径	说明
POST	`/v1/translate/webpage`	整页网页翻译（传 URL 或 HTML 源码）

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

调用要点

可传入公网可访问的 URL，或直接提交 HTML 源码；动态渲染（JS 生成）内容以提交时抓取到的 DOM 为准。
按实际翻译的文本字符数计费，HTML 标签本身不计费。
页面包含大量重复模板文案时，建议接入侧做缓存，避免重复计费。

支持语种

网页原文语种自动检测。
网页翻译只走标准档模型，目标语言不含传统蒙古文、藏语、哈萨克语、维吾尔语等小语种。

目标语言（参数 targetLang）：

代码	语种	说明
`zh`	中文	简体中文
`en`	英语	—
`xle_mw`	西里尔蒙古文	蒙古国通用的西里尔字母书写
`ru`	俄语	—
`es`	西班牙语	—
`fr`	法语	—
`de`	德语	—
`ja`	日语	—
`ko`	韩语	—
`pt`	葡萄牙语	—
`ar`	阿拉伯语	—
`hi`	印地语	—
`id`	印尼语	—
`yue`	粤语	繁体书写

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

计费

计费单位：字符
每月免费额度于月初重置，优先于余额抵扣；超出部分按单价从智能云余额扣费。
仅对成功的调用计费；失败调用不扣费。
实时单价与免费额度见本页下方「当前价格」（后台调价即时生效），总规则见「计费与免费额度」。

当前价格

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

计费单位	单价	每月免费额度
按字符计费	¥0.4 / 千字符	1 万字符 / 月

API 参考

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

翻译网页

POST/v1/translate/webpage

服务端抓取公网网页（10 秒超时、页面 ≤5MB、拒绝内网地址），提取正文文本段后整页上下文翻译。单次可翻译文本上限 30000 字符，按全部原文字符计费。

请求参数application/json

参数	类型	说明
`url`必填	string	公网网页地址（http/https；未带协议时按 https 处理）示例：`https://www.example.com/news/2026/some-article`
`targetLang`必填	string	目标语言可选值：`zhenxle_mwruesfrdejakoptarhiidyue` 示例：`zh`
`format`可选	string	返回格式：segments 段落对照（默认）/ markdown 拼接译文可选值：`segmentsmarkdown` 示例：`segments`

响应示例200 · application/json

200 响应

{
  "title": "Mongolian Language - Example News",
  "translatedTitle": "蒙古语 - 示例新闻",
  "targetLang": "zh",
  "billedChars": 5230,
  "segments": [
    {
      "source": "Mongolian is an official language of Inner Mongolia.",
      "translation": "蒙古语是内蒙古的官方语言之一。"
    }
  ],
  "markdown": "# 蒙古语 - 示例新闻\n\n蒙古语是内蒙古的官方语言之一。……"
}

代码示例

curl -X POST "https://cloud.heimori.cn/v1/translate/webpage" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.example.com/news/2026/some-article",
  "targetLang": "zh",
  "format": "segments"
}'