API 参考文档
SciFig API
通过 HTTP 创建科研插图、图表和流程图，使用与 SciFig 网站相同的引擎、价格和积分。
快速开始#
- 在设置 → 开发者中创建 API 密钥。生成密钥需要有效订阅或大于零的积分包余额；所有账号均可使用只读密钥。
- 发送创建请求时带上
Idempotency-Key。使用Prefer: wait=25时，响应最多等待 25 秒；若任务在此期间完成，则直接返回已完成的任务。 - 若任务仍为
queued或processing，遵循Retry-After，每隔几秒读取GET /jobs/{id}，直到状态为succeeded或failed。 - 通过每个输出的
download_url下载结果（链接有效期为一小时），或将其file_id传给其他端点。
curl -X POST https://scifig.ai/api/v1/images/generations \
-H "Authorization: Bearer $SCIFIG_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Prefer: wait=25" \
-H "Content-Type: application/json" \
-d '{"prompt": "Mitochondrial electron transport chain, labelled", "aspect_ratio": "4:3"}'基础 URL：https://scifig.ai/api/v1。机器可读接口契约：OpenAPI JSON 和 OpenAPI YAML。AI 助手可通过 MCP 服务器使用相同功能。
端点#
| 端点 | 功能 | 积分 |
|---|---|---|
| POST /images/generations | 根据提示词生成科研插图 | 50 / 75 / 100 |
| POST /images/edits | 按指令或区域编辑、设置白色背景、调整宽高比、重新配色、替换文字 | 50 / 75 / 100；区域编辑或文字替换为 100 |
| POST /images/text-detections | 替换前识别图中的文字 | 0 |
| POST /images/upscales | 放大到 2K、4K 或 8K | 50 / 100 / 150 |
| POST /images/conversions | SVG 矢量化；导出 PNG、PDF、TIFF 和 PPTX | SVG 150；PNG、PDF、TIFF 和 PPTX 免费 |
| POST /charts/generations | 根据 CSV、TSV 或 Excel 数据绘制图表 | 100 |
| POST /charts/edits | 修改图表的最新版本 | 100 |
| POST /flowcharts/generations | 绘制 SVG 流程图 | 100 |
| POST /flowcharts/edits | 修改流程图的最新版本 | 100 |
| POST /files | 上传图像、蒙版或附件 | 0 |
| GET /files/{file_id} | 下载文件 | 0 |
| GET /jobs/{id} | 读取单个任务 | 0 |
| GET /jobs | 列出最近的任务 | 0 |
| GET /credits | 余额、档位和任务限制 | 0 |
| GET /pricing | 所有价格（无需鉴权） | 0 |
| GET /openapi.json | OpenAPI 3.1 描述（无需鉴权） | 0 |
| GET /openapi.yaml | 相同描述的 YAML 版本（无需鉴权） | 0 |
目前没有 webhook、SDK 或命令行工具。请直接在服务器或脚本中调用端点（API 不允许浏览器 CORS 请求）。