# SciFig API

透過 HTTP 建立科學插圖、圖表和流程圖，使用與 SciFig 網站相同的引擎、價格和點數。

來源：https://scifig.ai/zh-Hant/docs/api

## 快速開始

- 在[設定 → 開發者](/zh-Hant/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-Hant/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 請求）。