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"}'开始使用
- 1
登录
使用你的 SciFig 账号。所有账号均可使用只读密钥；创建插图的密钥需要有效订阅或大于零的积分包余额。
- 2
创建密钥
在设置 → 开发者中选择只读或读取与生成，并设置有效期。密钥仅显示一次。
- 3
调用并等待
发送带有 Idempotency-Key 和
Prefer: wait=25的请求，然后下载输出，或持续读取任务直到完成。
API 的功能
图像生成
POST /images/generations
根据提示词生成科研插图，支持样式、配色和最多三张参考图像。
图像编辑
POST /images/edits
按指令或蒙版区域编辑、白色背景、新宽高比、重新配色，或原位替换文字。
图像放大
POST /images/upscales
放大到 2K、4K 或 8K，适合印刷。
格式转换
POST /images/conversions
矢量化为可编辑 SVG；以 300–1000 DPI 导出 PNG、PDF、TIFF 和 PPTX，包括流程图。
图表
POST /charts/generations
根据 CSV 或 Excel 数据按期刊样式绘制可用于发表的图表，并支持后续编辑。
流程图
POST /flowcharts/generations
以可编辑 SVG 制作 CONSORT 图、工作流程图和管线图，并支持后续编辑。
文件
POST /files · GET /files/{id}
上传图像、蒙版和附件；通过签名链接下载每个输出。
任务与积分
GET /jobs/{id} · GET /credits
状态、输出，以及准确的预留、扣除和返还积分。
在 AI 助手中工作？
将 Claude、ChatGPT、Claude Code、Codex 或 Cursor 连接到 SciFig MCP 服务器。Claude、ChatGPT、Claude Code 和 Codex 使用 SciFig 账号登录；Cursor 使用 API 密钥。
每次调用的费用
| Operation | Credits |
|---|---|
| 图像生成 | 50 / 75 / 100 (standard / advanced / premium) |
| 图像编辑 | 50 / 75 / 100；区域编辑或文字替换为 100 |
| 文字识别 | 免费 |
| 放大 | 50 / 100 / 150 (2K / 4K / 8K) |
| 转换 | SVG 150；PNG、PDF、TIFF 和 PPTX 免费 |
| 图表生成或编辑 | 100 |
| 流程图生成或编辑 | 100 |
| 读取任务、文件、积分和价格 | 免费 |
任务开始时预留积分，成功后仅扣除一次，失败时全额返还。所有价格。
限制
20
每个密钥每分钟创建请求数
40
每个账号每分钟创建请求数
120
每个密钥每分钟读取请求数
30 s
每个请求的最长等待时间
200
每日免费位图转换次数
运行中任务数和每小时任务数遵循档位限制，与网站共享。429 包含 Retry-After：等待后使用相同 Idempotency-Key 重试。
常见问题
需要付费档位吗？+
所有账号均可使用只读密钥。创建插图的密钥需要有效订阅或大于零的积分包余额，因为每次创建都消耗积分。
API 积分与网站积分分开吗？+
不分开。网站、API 和 MCP 服务器共用一个余额和同一份价格表。
任务失败会怎样？+
预留积分全额返还。超时的插图仍可能在 24 小时内免费交付；任务会注明截止时间。
结果会出现在网站上吗？+
会。图表和流程图会作为对话出现在各自工作台中，可以继续编辑；输出携带 editor_url，可直接打开对应工作台。API 响应中的下载链接有效期一小时，重新读取任务可获得新链接。
有测试模式吗？+
没有。只读调用及 PNG、PDF、TIFF 和 PPTX 转换免费，因此可以在不消耗积分的情况下完成大部分集成接线。
可以提高限制吗？+
请通过联系页面说明预计使用量。
从上面的请求开始
创建密钥，将 cURL 命令粘贴到终端，约一分钟即可生成插图。