几何题配图 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. 后端提交异步任务
curl-XPOST 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，本质上是在选择一条内容生产链。理想结果不是一次生成一张图，而是题目可以持续进入“生成、审核、修改、渲染、入库”的可追踪流程。
相关入口：
- 智能生图 API
- Render API
- 大角几何开放平台