Academic Figure Generator API参考速查项目、文档、Prompt、图片接口完整一览【免费下载链接】academic-figure-generatorAI 驱动的学术论文配图生成平台。上传论文 → AI 分析内容生成 Prompt → 一键生成高质量科研配图还有配套的skill可在主流agent中使用项目地址: https://gitcode.com/gh_mirrors/ac/academic-figure-generatorAcademic Figure Generator是一款 AI 驱动的学术论文配图生成平台支持上传论文、AI 分析生成 Prompt、一键生成科研配图。本文是它的API 接口速查手册完整梳理了项目、文档、Prompt、图片、配色五大模块的全部接口路径与关键参数帮你在 10 分钟内掌握学术配图接口的调用方式 快速开始基础地址与健康检查启动后端后详见 README.md所有接口都挂在统一前缀/api/v1下交互式文档见http://localhost:8000/docs仅在 DEBUG 模式启用由 backend/app/main.py 控制。用途方法路径说明健康检查GET/api/v1/health返回{status: ok}部署后先探活对应的路由注册逻辑见 backend/app/api/v1/health.py。 个人本地版无鉴权设计接口可直接调用数据库与文件零配置首次启动自动创建。下图是平台实际生成的配图效果也是这套 API 的最终产出形态项目接口速查管理论文、Prompt 与配图的容器项目Project是组织论文、Prompt 和配图的核心单位接口定义在 backend/app/api/v1/projects.py。操作方法路径说明创建项目POST/api/v1/projects/返回 201可设置领域、配色方案项目列表GET/api/v1/projects/支持page、page_size、status分页查询项目详情GET/api/v1/projects/{project_id}附带文档/Prompt/图片数量统计更新项目PUT/api/v1/projects/{project_id}部分字段更新删除项目DELETE/api/v1/projects/{project_id}软删除标记deleted项目详情响应中自带document_count、prompt_count、image_count三个统计字段做状态面板时非常方便。文档接口上传论文并同步解析文档接口backend/app/api/v1/documents.py负责上传 PDF / DOCX / TXT 论文。关键点上传即解析响应返回时解析状态已是completed或failed无需轮询。操作方法路径说明项目文档列表GET/api/v1/projects/{project_id}/documents按创建时间倒序上传论文POST/api/v1/projects/{project_id}/documentsmultipart 文件上传返回 201文档详情GET/api/v1/documents/{document_id}含全文、章节结构、页数⚠️ 注意上传接口要求项目至少处于活跃状态单文件大小上限默认 50 MBMAX_UPLOAD_SIZE_MB可配置。解析出的sections章节结构会作为后续 Prompt 生成的输入。Prompt 接口AI 分析论文生成配图描述这是整个平台最核心的接口 —— Claude AI 读取论文章节自动产出详细的英文配图 Promptbackend/app/api/v1/prompts.py。操作方法路径说明AI 生成 PromptPOST/api/v1/projects/{project_id}/prompts/generate同步调用 Claude返回 201 及 Prompt 列表Prompt 列表GET/api/v1/projects/{project_id}/prompts按 figure_number 排序Prompt 详情GET/api/v1/prompts/{prompt_id}编辑 PromptPUT/api/v1/prompts/{prompt_id}保存人工修改后的edited_prompt状态查询GET/api/v1/prompts/{prompt_id}/status轻量级状态接口生成接口的主要请求参数定义见 backend/app/schemas/prompt.pysection_indices指定参与分析的章节下标省略则使用全部color_scheme配色方案标识默认okabe-ito色盲友好figure_types/user_request/max_figures控制图表类型、附加需求与生成数量调用前提项目下必须存在至少一篇解析完成的文档否则返回 400。生成的 Prompt 支持二次编辑active_prompt字段会优先取人工修改版本 —— 这就是AI 生成 人工确认双保险机制。图片接口生成、轮询、下载与图生图编辑图片接口backend/app/api/v1/images.py全部采用异步任务 状态查询模式提交后返回 202 和图片id再通过状态接口或 SSE 流跟踪进度。操作方法路径说明基于 Prompt 生成POST/api/v1/prompts/{prompt_id}/images/generate返回 202默认 2K / 16:9快捷直接生成POST/api/v1/images/generate-direct无需上传论文直接输入 Prompt 文本项目图片列表GET/api/v1/projects/{project_id}/images按创建时间倒序图片详情GET/api/v1/images/{image_id}含尺寸、耗时、下载链接下载图片GET/api/v1/images/{image_id}/download直接返回图片二进制流状态查询GET/api/v1/images/{image_id}/status状态pending → generating → completed / failed图生图编辑POST/api/v1/images/{image_id}/edit返回 202表单传edit_instruction可附加参考图SSE 实时推送GET/api/v1/images/{image_id}/stream每 2 秒推送一次状态收到done事件即结束生成参数见 backend/app/schemas/image.pyresolution支持 1K / 2K / 4Kaspect_ratio支持 16:9 / 4:3 / 1:1 等比例。若NANOBANANA_API_KEY未配置接口会明确返回 400 提示。推荐的轮询方案不想接 SSE 的话每 3 秒轮询一次/status直到generation_status变为终态即可实现同样简单。配色方案接口50 预设与自定义配色配色接口backend/app/api/v1/color_schemes.py管理学术配色方案系统预置 50 套含色盲友好的 Okabe-Ito 等首次启动时自动写入数据库。操作方法路径说明列表GET/api/v1/color-schemes/默认方案置顶按名称排序新建自定义POST/api/v1/color-schemes/返回 201更新PUT/api/v1/color-schemes/{scheme_id}系统预置方案不可改删除DELETE/api/v1/color-schemes/{scheme_id}返回 204预置方案不可删接口速查总表与源码地图一张表回顾全部 20 个接口的调用链路创建项目 → 上传文档 → 生成 Prompt → 编辑确认 → 生成图片 → 轮询下载。模块接口数源码位置Health1backend/app/api/v1/health.pyProjects5backend/app/api/v1/projects.pyDocuments3backend/app/api/v1/documents.pyPrompts5backend/app/api/v1/prompts.pyImages8backend/app/api/v1/images.pyColor Schemes4backend/app/api/v1/color_schemes.py请求/响应结构定义集中在 backend/app/schemas/ 目录业务逻辑Claude 调用、图片生成、文档解析在 backend/app/services/ 下配合 docs/phase2-technical-design.md 可以深入理解整体设计。 不想部署完整平台仓库还附带了 academic-figure-prompt/SKILL.md 技能文件可直接在主流 AI 编程助手中生成顶会级论文配图 Prompt零部署上手。掌握以上接口后无论是二次开发、接入自研前端还是写自动化脚本这套学术配图 API 都能帮你把论文配图变成一条流水线上的自动化步骤 ✨【免费下载链接】academic-figure-generatorAI 驱动的学术论文配图生成平台。上传论文 → AI 分析内容生成 Prompt → 一键生成高质量科研配图还有配套的skill可在主流agent中使用项目地址: https://gitcode.com/gh_mirrors/ac/academic-figure-generator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考