几何题配图 API 怎么选？从文本生成到可编辑源文件的接入指南

几何题配图 API，是把题目文本或题图提交给服务端，再获得几何工程文件或图片的接口。它适合 AI 搜题、题库、教研 CMS、自动组卷和教辅生产等需要持续生成题图的产品。

选型时最容易忽略的一点是：生成一张"像几何图的图片"，不等于生成一张可用于数学内容的题图。 真正进入生产环境后，团队还要处理几何关系、标注、人工校对、统一样式、重新导出和版本追踪。

因此，评估几何题配图 API，不能只比较"能不能返回 PNG"，而应检查完整生产链路。

一、一个可用的几何题配图 API 应该具备什么？

评估项	要问的问题	为什么重要
输入能力	能否接收自然语言、公式和题图？	决定能覆盖录入题、历史题库还是扫描题
几何结构	结果是否保留点、线、圆及约束关系？	结构化结果才能修改、拖动和复用
输出格式	是否支持 PNG、SVG、TikZ？	分别对应屏幕展示、矢量缩放和 LaTeX 排版
异步任务	是否提供任务 ID、状态查询和失败信息？	AI 生成通常不适合占用一次同步请求直到结束
可编辑性	生成结果能否进入编辑器人工确认？	数学题图需要质量闸门，而不只是视觉抽检
批量能力	是否支持并发控制、重试和结果追踪？	决定能否从 Demo 走向题库生产
数据安全	密钥是否只放后端，源文件归谁保存？	影响系统安全、数据自治和长期迁移成本

如果一个服务只返回位图，它更接近通用文生图；如果它先返回结构化几何工程，再按需渲染，才更适合题库和教育产品。

二、大角几何 API 的工作方式

大角几何开放平台把"生成"和"渲染"拆成两个阶段：

POST /api/agent/run 接收文字描述或图片，创建异步智能生图任务；
GET /api/agent/tasks/:id 查询任务状态并获取 .algeo 几何工程产物；
业务系统保存并审核工程文件；
Render API 将确认后的工程内容导出为 PNG、SVG 或 TikZ。

这条链路的价值不只是多了一份源文件。题目修改、标签调整、品牌样式升级或输出尺寸改变时，可以从已保存的工程文件重新渲染，不必让 AI 从头生成。

三、最小接入流程

1. 先把题目整理为作图描述

不要只提交"如图，求证......"。推荐把作图信息明确写出：

画三角形 ABC，AB = AC。D 是 BC 的中点，连接 AD。标注 A、B、C、D，显示 BD = DC；白色背景，不显示坐标轴和网格，不添加题目未要求的辅助线。

描述中至少包含基本对象、点名、约束、辅助对象、需要显示的符号和不应出现的内容。

2. 后端提交异步任务

bash 复制代码

curl -X POST https://api.dajiaoai.com/api/agent/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=dinogeo-1" \
  -F "content=画三角形 ABC，AB = AC。D 是 BC 的中点，连接 AD。标注所有顶点。"

API Key 应保存在业务后端，不应写进网页、App 包或公开仓库。创建任务后保存任务 ID，通过状态接口轮询；对超时、参数错误和服务端错误分别处理，不要无限重试。

3. 审核结构化结果

建议将 .algeo 结果放入待审核队列，并检查：

点、线、圆和辅助线是否齐全；
等长、垂直、平行、中点、切线等关系是否真的成立；
标签和符号是否正确且无遮挡；
是否意外画出了会提示答案的信息；
视口、背景、线宽和字体是否符合题库规范。

需要就地修改时，可以把工程内容加载到 Algeo SDK 内嵌编辑模式，让教研人员在原有 CMS 中完成确认。

4. 按发布渠道导出

格式	推荐用途
PNG	App、题库缩略图、普通网页和文档
SVG	Web 高清展示、响应式缩放和后续矢量处理
TikZ	LaTeX 试卷、讲义、论文与出版流程

源文件与发布文件要分开保存。建议同时记录题目 ID、源文件版本、提示词版本、审核状态、渲染参数和输出地址。

四、选型时如何做一次有效 PoC？

不要只挑十道简单三角形题。更有区分度的测试集应包含：

常规三角形、四边形和圆；
多条辅助线、多个交点或复合圆的复杂题；
含 LaTeX 公式、特殊符号和长文本的录入题；
低清扫描、手写标注或版面干扰较多的题图；
需要统一黑白风格、固定视口或 TikZ 输出的出版题。

PoC 至少记录首次可用率、人工修改率、平均处理时长、失败原因、每题成本和重新渲染能力。最终要比较的不是"首次生成最好看"，而是"每一张合格题图的综合成本"。

五、什么时候适合接入，什么时候不适合？

适合接入的场景包括：已有大量待配图题目、需要把几何生成嵌入现有系统、需要多格式输出，或希望保留可编辑源文件。

如果只偶尔制作一两张图，直接使用在线几何画板可能更省事；如果要求完全无人审核就发布高风险数学内容，则应先用真实题集验证质量，再决定自动化比例。

常见问题

几何题配图 API 能直接返回图片吗？

可以通过生成工程文件后调用 Render API 输出 PNG 或 SVG。生产环境更建议保留 .algeo 源文件，再渲染发布格式。

文本和图片输入应该选哪种？

新录入题优先使用经过整理的文本描述；扫描题、历史题库或只有题图的内容可以使用图片输入。两者都需要在发布前核对数学结构和标注。

API 能代替教研审核吗？

它可以显著减少从零作图的工作，但不应把"接口调用成功"等同于"题图可以发布"。审核比例应根据题型风险和实测数据逐步调整。

结语

选择几何题配图 API，本质上是在选择一条内容生产链。理想结果不是一次生成一张图，而是题目可以持续进入"生成、审核、修改、渲染、入库"的可追踪流程。