figup-cli

FigUP 命令行工具：使用 REST API（请求头 X-API-Key）。在 FigUP 控制台 复制个人 Key 后，用 figup setup 或环境变量配置即可。

安装

npm install -g figup-cli
figup setup

或使用 npx：

npx figup-cli setup

命令

figup setup                      # 交互式粘贴 API Key，写入 ~/.figup
figup generate <文案> [宽高比]   # 生成科研插图（POST /api/v1/generate）
figup balance                    # 查询 Credit（GET /api/v1/credits）
figup history [数量]             # 生成历史（GET /api/v1/history）
figup help                       # 帮助

环境变量

| 变量 | 说明 | |------|------| | FIGUP_API_KEY | 控制台复制的个人 API Key（也可写入 ~/.figup） | | FIGUP_API_URL | 站点根 URL，默认 https://figup.cn（请求路径为 /api/v1/...） |

API 说明

见 https://figup.cn/docs/：

• 认证：请求头 X-API-Key
• 基础路径：{FIGUP_API_URL}/api/v1/
• 生成：POST /generate，请求体 text、aspectRatio
• 余额：GET /credits
• 历史：GET /history?limit=20（最大 100）

示例

export FIGUP_API_KEY="xhs_your_api_key"
figup generate "肿瘤微环境中巨噬细胞极化与 T 细胞耗竭的关联机制"
figup generate "示意图标题" 16:9
figup balance
figup history 20

链接

• 官网：https://figup.cn
• API 文档：https://figup.cn/docs/