總覽

SciDraw AI 的 REST API 以穩定的任務制端點，提供影像生成、影像編輯與格式轉換能力。

基礎網址： https://sci-draw.com

機器可讀的介面描述： OpenAPI JSON · OpenAPI YAML

這兩個檔案用 OpenAPI 格式描述的是同一套介面。把任一個匯入 Postman 或 Insomnia，所有端點與參數都會自動填好；交給程式碼產生器可以直接產出具型別的 用戶端；交給 AI 代理，它就能自行呼叫而不需要你手寫請求。兩種格式內容等價， 選你的工具支援的那一種即可。

快速開始

1. 在設定 → API 金鑰建立金鑰，只勾選整合實際需要的 權限範圍。
2. 以 Authorization: Bearer sd_... 傳送金鑰。
3. 每個建立請求都要帶上唯一的 Idempotency-Key。
4. 保存回傳的任務 ID，並輪詢 Location 網址，直到任務進入 succeeded、 failed 或 canceled。

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

建立請求通常回傳 202 Accepted、任務物件、Location 標頭與 Retry-After: 2。 你可以加上 Prefer: wait=10，最多等待 10 秒。等待不會改變任務本身的語意：只有 任務已經進入終態時才回傳 200，否則仍是 202。

端點

所有回應都是 JSON 封裝結構。每個回應都帶有 X-Request-Id，聯絡技術支援時請一併 提供該 ID。回應中唯一的檔案參照是輸出網址與公開檔案 ID。能力路由由 SciDraw AI 負責管理。