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 命令貼上到終端，約一分鐘即可產生插圖。