极度公式 极度公式

DEVELOPER DOCUMENTATION

公式识别与 LaTeX 工具接口

通过统一的 HTTP 接口调用 LaTeX 转换与公式 OCR 能力。

Base URLhttps://api.wlhex.com:881 接口前缀/api/formula 请求方式POST / GET

START HERE

概述

所有接口使用 UTF-8 编码。大多数接口以 POST 和 application/x-www-form-urlencoded 提交普通参数；OCR 图片上传使用 multipart/form-data；剩余识别次数查询使用 GET。

Token 使用说明

Token 为必填参数，且必须存在于服务端 Redis 会话中。获取 Token 需要极度公式版本高于 1.5.2，且客户端程序须处于打开状态（可最小化至系统托盘）。请在“设置 → Token”复制有效 Token。

安全建议

Token 是访问凭证。请勿将其写入前端源码或日志。POST 示例通过请求体传递；剩余识别次数查询按接口定义通过 Query String 传递，必须使用 HTTPS 并避免记录完整请求 URL。

RESPONSE FORMAT

通用响应结构

所有接口返回 CommonReturnType，由 status 表示业务结果，成功时结果位于 info。

字段类型说明
statusInteger1 成功；-1 失败；-2 当前用户未获功能使用资格
dataString业务提示信息
infoObject成功结果或补充信息；失败时通常为 null
成功响应
{
  "status": 1,
  "data": "成功",
  "info": "业务结果"
}
1请求已成功处理
-1Token 无效、请求失败或额度用尽
-2AI 功能候选资格校验未通过
status典型 data 值含义
-1失败:token参数为空未传递 Token
-1失败:token验证失败 或 失败:token权限验证失败Token 无效、过期或不具备访问条件
-1失败:当天免费次数已经用完...免费额度已用尽且无额外次数，info 固定为 "limit"
-1抱歉:该功能暂未对您开放!需要 VIP 或功能暂未开放
-2抱歉:功能暂未对您开放，您可以尝试申请加入候选队列!AI 功能候选资格校验未通过

SHARED PARAMETERS

公共参数

参数名类型必填位置说明
tokenString是表单字段或 Query String用户登录后获得的有效 Token，具体位置以接口定义为准
latexString按接口要求表单字段待转换、翻译、处理或提问的 LaTeX 内容

提交 LaTeX 时应使用 URL 编码，避免 &、+、#、反斜杠等字符被错误解析。下方 cURL 示例使用 --data-urlencode。

LATEX CONVERSION

LaTeX 转换接口

以下接口均需要有效 Token，并以表单编码提交 token 与 latex。

POST

LaTeX 转 MathML

将 LaTeX 公式转换为 MathML 字符串。

/api/formula/latexToMathML

成功时 info说明
StringMathML 内容
cURL
curl --request POST "https://api.wlhex.com:881/api/formula/latexToMathML" \
  --header "Accept: application/json" \
  --data-urlencode "token=${USER_TOKEN}" \
  --data-urlencode "latex=\\frac{a}{b}"
POST

LaTeX 转 Word 文件

根据 LaTeX 生成 Word 公式文件。成功后对 info 进行 Base64 解码并保存为 .docx 文件。

/api/formula/latexToWord

输入限制仅支持极度公式识别产生的、保留原始包裹符的 LaTeX；支持 LaTeX 表格转换。额度规则非 VIP 用户受每日动态额度限制；额度耗尽时仍可能返回成功，但文件内容为开通会员提示。成功时 infoWord 文件的 Base64 内容。
cURL
curl --request POST "https://api.wlhex.com:881/api/formula/latexToWord" \
  --header "Accept: application/json" \
  --data-urlencode "token=${USER_TOKEN}" \
  --data-urlencode "latex=E=mc^2"
POST

标准化 LaTeX

修正并统一 LaTeX 的包裹符、符号和常见排版格式。

/api/formula/latexToStandard

成功时 info标准化后的 LaTeX。额度规则非 VIP 用户受每日动态额度限制；额度耗尽时，结果末尾会追加会员提示文本。
cURL
curl --request POST "https://api.wlhex.com:881/api/formula/latexToStandard" \
  --header "Accept: application/json" \
  --data-urlencode "token=${USER_TOKEN}" \
  --data-urlencode "latex=\\(x^2 + y^2 = z^2\\)"
POST

LaTeX 转 Markdown

将公式包裹符转换为 Markdown 数学公式格式。单独公式通常转换为 $$...$$，混排文本中的公式保留为 $...$ 或 $$...$$。

/api/formula/latexToMarkDown

成功时 infoMarkdown 文本。
cURL
curl --request POST "https://api.wlhex.com:881/api/formula/latexToMarkDown" \
  --header "Accept: application/json" \
  --data-urlencode "token=${USER_TOKEN}" \
  --data-urlencode "latex=\\frac{a}{b}"
POST

标准化 LaTeX 并移除 text 标签

在标准化 LaTeX 的基础上，移除或改写 \\text{...} 标签，以适配不支持该标签的下游渲染器。

/api/formula/latexToStandardRemoveTextLabel

成功时 info处理后的 LaTeX。额度规则非 VIP 用户受每日动态额度限制；额度耗尽时，结果末尾会追加会员提示文本。
cURL
curl --request POST "https://api.wlhex.com:881/api/formula/latexToStandardRemoveTextLabel" \
  --header "Accept: application/json" \
  --data-urlencode "token=${USER_TOKEN}" \
  --data-urlencode "latex=\\text{速度}=\\frac{s}{t}"

USAGE QUERY

GET

获取用户剩余公式识别次数

返回用户当前可用的基础公式识别次数和额外购买次数。

/api/formula/getUserFormulaRemainingCount

权限要求有效 Token。参数格式Query String。请求参数token成功时 info包含 baseCount 与 extraCount 的 Object。
返回字段类型说明
info.baseCountInteger基础剩余次数。VIP 按 150 次基础额度计算；非 VIP 按系统体验额度计算，均扣除已使用基础次数，最小为 0。
info.extraCountInteger额外购买的剩余识别次数，最小为 0。
cURL
curl --request GET --get "https://api.wlhex.com:881/api/formula/getUserFormulaRemainingCount" \
  --header "Accept: application/json" \
  --data-urlencode "token=${USER_TOKEN}"
成功响应
{
  "status": 1,
  "data": "成功",
  "info": {
    "baseCount": 120,
    "extraCount": 50
  }
}
Token 校验失败

Token 缺失时可能返回 失败:token无参数；Token 失效或无权限时返回 失败:token权限验证失败，两种情况的 info 均为 null。

FORMULA OCR

公式 OCR 接口

两项 OCR 接口均使用 multipart/form-data。请求必须包含有效 Token 和图片文件；用户还须至少绑定手机号或邮箱。

参数名类型必填说明
tokenString是用户登录 Token
image_fileFile是待识别公式的图片文件
图片建议

支持格式和文件大小以服务端 Spring 上传配置及图像解码器实际能力为准。建议上传清晰、正向、仅包含待识别内容的 PNG 或 JPEG 图片。

POST

快速公式识别

优先使用快速识别链路，适合清晰的单行或简单公式。

/api/formula/simpleFormulaOcr

请求格式multipart/form-data成功时 info识别出的 LaTeX 或文本。
cURL
curl --request POST "https://api.wlhex.com:881/api/formula/simpleFormulaOcr" \
  --header "Accept: application/json" \
  --form "token=${USER_TOKEN}" \
  --form "image_file=@./formula.png;type=image/png"
POST

高精度公式识别（含 NLP 纠错）

使用高精度公式识别链路，并结合 NLP 对识别结果进行纠错，适用于结构复杂、混排或对识别准确性要求较高的公式图片。

/api/formula/formulaOcr

请求格式multipart/form-data成功时 info识别出的 LaTeX 或文本。
cURL
curl --request POST "https://api.wlhex.com:881/api/formula/formulaOcr" \
  --header "Accept: application/json" \
  --form "token=${USER_TOKEN}" \
  --form "image_file=@./formula.png;type=image/png"
识别失败时

图片无法读取、识别服务繁忙或识别结果为空时，可能返回 status: -1 与“失败:识别错误(文字是否过小？分几次识别试试!)”。