# SciFig API

通过 HTTP 创建科研插图、图表和流程图，使用与 SciFig 网站相同的引擎、价格和积分。

来源：https://scifig.ai/zh/docs/api

## 快速开始

- 在[设置 → 开发者](/zh/app/settings?tab=developer)中创建 API 密钥。生成密钥需要有效订阅或大于零的积分包余额；所有账号均可使用只读密钥。
- 发送创建请求时带上 `Idempotency-Key`。使用 `Prefer: wait=25` 时，响应最多等待 25 秒；若任务在此期间完成，则直接返回已完成的任务。
- 若任务仍为 `queued` 或 `processing`，遵循 `Retry-After`，每隔几秒读取 `GET /jobs/{id}`，直到状态为 `succeeded` 或 `failed`。
- 通过每个输出的 `download_url` 下载结果（链接有效期为一小时），或将其 `file_id` 传给其他端点。

```bash
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](https://scifig.ai/api/v1/openapi.json) 和 [OpenAPI YAML](https://scifig.ai/api/v1/openapi.yaml)。AI 助手可通过 [MCP 服务器](/zh/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 请求）。