数学公式渲染

接口标识: formularender 价格: 0.0005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

数学公式渲染接口把LaTeX代码转换成公式图片：传代码直接渲染，或传一句自然语言描述（最长1000字符）先转成LaTeX再渲染，转换结果随响应回显便于核对。输出PNG或SVG图片地址，分辨率96~600可调（默认300），字号可缩放0.5~3倍，PNG支持透明背景，公式颜色可自定义；LaTeX最长5000字符。渲染为确定性过程，同一输入产出一致；不支持的LaTeX语法（前导宏、多行对齐环境等）会返回明确错误清单而非错图。适合题库试卷、课件插图、网页与文档的公式配图场景。

详细介绍

![数学公式渲染接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_formularender__1794363398_4e864ef4ecef.png)

网页和文档里排公式总让前端与编辑头疼。数学公式渲染接口传入LaTeX代码或一句自然语言描述，即可得到一张排版标准的公式图片。

## 接口概述
面向教育、出版与内容平台的排版场景，支持两种输入：直接传LaTeX代码（最长5000字符）即传即渲染；或传自然语言公式描述（最长1000字符），接口先把描述翻译成LaTeX再渲染，最终所用代码随响应回显，便于核对与二次修改。输出PNG或SVG格式的图片地址，分辨率、字号缩放、背景透明度与公式颜色均可自定义。渲染是确定性过程，同一输入产出恒定一致；遇到不支持的LaTeX语法时不出错图，而是返回明确错误清单指出不支持的命令，指导改写。

## 核心能力
1. **双入口渲染**：latex代码直渲，text自然语言描述先转码再渲染，二者至少传其一，同传时latex优先。
2. **双格式产物**：PNG位图适合网页与课件，SVG矢量无损缩放适合印刷与高清屏。
3. **外观可调**：dpi分辨率96~600（默认300），字号缩放0.5~3倍（默认1），公式颜色支持3位或6位十六进制色值（默认黑色）。
4. **透明背景**：PNG产物默认透明背景，可自然融入任意底色的课件与页面，也可关闭换成白底。
5. **明确报错**：不支持的前导宏与多行对齐环境等语法直接列出命中项并给出改写指引，不静默输出错图。

## 产品优势
1. **接入简单**：单次POST同步返回图片地址与宽高信息，无需自建排版渲染引擎。
2. **结果确定**：同一输入渲染结果恒定一致，适合题库、出版等要求可复现的场景。
3. **门槛更低**：不会写LaTeX的同事用自然语言描述也能出图，转换后的代码回显供确认修改。
4. **产物规范**：自动返回图片像素宽高与实际渲染参数，排版系统可精确预留版面。
5. **生态开放**：可与公式识别接口串联使用——识别出的LaTeX代码直接交给本接口出图。

## 效果展示
一句话理解：它就像一间只排公式的排版室，你把代码递进去、甚至只说一句话，它排好版打成图片递回来。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| text | 勾股定理：直角三角形斜边的平方等于两直角边平方和 | 自然语言公式描述，最长1000字符；与latex二选一 |
| format | `"png"` | 产物格式：png或svg |
| dpi | `300` | 分辨率，96~600，默认300 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 公式图片地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261112/formula_20261112_103000.png | `image_url`，可直接在网页与文档中引用 |
| 最终所用代码 | `"a^2 + b^2 = c^2"` | `latex_used`，自然语言入口时回显翻译结果供核对 |
| 是否经描述翻译 | `true` | `via_model`，传text时为true，传latex时为false |
| 图片宽高 | `551` / `132` | `width`、`height`，像素值，便于排版预留位置 |
| 产物格式与分辨率 | `"png"` / `300` | `format`、`dpi`，实际产物参数回显 |

API请求示例：

```text
POST /api/formularender
text=勾股定理：直角三角形斜边的平方等于两直角边平方和&format=png&dpi=300
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "image_url": "https://fujian.phpwc.com/pyapi/uploads/api/20261112/formula_20261112_103000.png",
    "latex_used": "a^2 + b^2 = c^2",
    "via_model": true,
    "width": 551,
    "height": 132,
    "format": "png",
    "dpi": 300
  },
  "request_id": "req-formularender-demo01"
}
```

传自然语言时via_model为true、latex_used回显翻译所得代码；若翻译结果不符合预期，可自行修改代码后改用latex入口重新调用，渲染段产出与入口无关、完全一致。

## 应用场景
1. **题库与考试系统**：公式以代码存库、组卷时统一出图，多端展示与打印效果一致。
2. **课件制作**：把公式描述转成图片插入幻灯片，无需掌握排版语法。
3. **网页内容**：不便引入前端渲染脚本时直接使用图片地址，SVG可无损缩放。
4. **学术海报与文档**：300以上dpi高分辨率出图，满足印刷输出要求。

## 应用案例
一家考试系统公司此前靠前端渲染库显示公式，不同浏览器版本效果不一、导出试卷还常乱码；改为服务端统一出图后，题目展示与打印结果完全一致，也不必再维护各种前端兼容方案。

一个知识付费团队的内容编辑不会写LaTeX，课程里的公式只能从教材截图，风格不统一还模糊；现在把自然语言描述发给后台调用接口，得到标准公式图片，全课程风格统一、清晰度可调。

一个科普网站的站长想给文章配公式，引入数学渲染脚本又担心拖慢页面；改为编辑时调用接口生成SVG存入图片库，页面加载不受影响，公式在高分屏上依旧清晰。

常见问题

Q：latex参数应该传什么写法？

A：传数学主体本身即可，分式用\frac{}{}，无需$定界符。\usepackage、\documentclass、\newcommand、\input等前导命令与align、cases等多行对齐环境不支持，传入会返回明确错误并列出命中的不支持项。

Q：text和latex两个入口有什么区别？

A：latex直接渲染你给的代码；text传自然语言描述，接口先翻译成LaTeX再渲染，latex_used回显翻译结果、via_model为true。翻译结果不符合预期时，可修改代码后改用latex入口重新调用。

Q：PNG和SVG怎么选？

A：PNG是位图，适合网页与课件展示，支持透明背景（transparent_bg默认开启）；SVG是矢量图，无损缩放，适合印刷与高分屏。format参数二选一，默认png。

公式渲染 LaTeX 公式图片排版工具教育科技 SVG 题库

接口地址： https://www.phpwc.cn/api/formularender

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`latex`	string	选填	-	LaTeX 公式代码，≤5000 字符（与 text 二选一，优先 latex）
`text`	string	选填	-	自然语言公式描述，≤1000 字符（与 latex 二选一，走模型段转 LaTeX）
`format`	string	选填	`png`	产物格式：png（默认）/ svg
`dpi`	int	选填	`300`	分辨率，int 96~600，默认 300
`scale`	float	选填	`1`	字号缩放，float 0.5~3，默认 1
`transparent_bg`	boolean	选填	`true`	透明背景（仅 png 有效），默认 true
`color`	string	选填	`#000000`	公式颜色 hex，默认 #000000

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`image_url`	string	公式图片下载地址
`latex_used`	string	最终渲染所用的 LaTeX（text 入口时回显模型翻译结果）
`via_model`	boolean	本次是否走了模型段（传 text 时为 true）
`width`	int	图片像素宽度
`height`	int	图片像素高度
`format`	string	实际产物格式：png / svg
`dpi`	int	实际渲染 dpi
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试