REST API 快速接入

认证方式：请求头携带 X-API-Key（登录后在个人中心复制个人 Key）。

基础地址

将下列 https://www.figup.cn/ 替换为你部署站点根 URL。

https://www.figup.cn/api/v1/

生成科研插图

POST/api/v1/generate

{
  "text": "肿瘤微环境中巨噬细胞极化与 T 细胞耗竭的关联机制",
  "aspectRatio": "1536x1024",
  "serviceMode": "fast"
}

aspectRatio 默认 1536x1024；支持：1536x1024（横版）、1024x1536（竖版）、2048x2048（2K正方形）、2048x1152（2K横版）。旧比例值会自动兼容映射。

serviceMode 可选：fast（快速）或 fine（精细）。

响应示例：

{
  "success": true,
  "taskId": "uuid",
  "resultUrl": "https://你的域名/media/...",
  "creditCost": 10,
  "balance": 90
}

cURL

curl -X POST https://www.figup.cn/api/v1/generate \
  -H "X-API-Key: sci_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "肿瘤微环境中巨噬细胞极化与 T 细胞耗竭的关联机制"}'

查询余额

GET/api/v1/credits

curl -H "X-API-Key: sci_your_api_key" https://www.figup.cn/api/v1/credits

响应字段：balance、totalUsed、totalPurchased。

生成历史

GET/api/v1/history，支持 ?limit=20（最大 100）。

错误码

更新日志 ← 返回首页