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 請求）。