影像轉換

POST /api/v1/images/conversions 接受 multipart/form-data。所需權限範圍： images:convert。

表單欄位

欄位	型別	必填	預設值	規則
`image`	file	是	—	PNG、JPEG 或 WebP；最大 10 MiB，解碼後最多 4,000 萬像素
`format`	string	是	—	`svg`、`pptx`、`png`、`pdf` 或 `tiff`
`vector_mode`	string	否	`editable_text`	僅適用於 SVG
`dpi`	string	否	`300`	`300`、`600` 或 `1000`；僅適用於 PNG、PDF、TIFF

兩種 SVG 模式

兩個 SVG 選項都已實作，並透過同一個端點提供：

`vector_mode`	結果	點數
`editable_text`	在可行範圍內保留可編輯文字的 SVG	10
`full_vector`	完全向量化的 SVG 輸出	15

這些名稱描述的是輸出能力。能力路由由 SciDraw AI 管理，不屬於公開契約的一部分。

其他格式與點數

格式	選項	點數
`pptx`	—	10
`png`、`pdf`、`tiff`	`dpi=300`	5
`png`、`pdf`、`tiff`	`dpi=600`	10
`png`、`pdf`、`tiff`	`dpi=1000`	15

對非 SVG 格式指定 full_vector，或對 SVG／PPTX 指定非預設的 DPI，都會回傳 400 INVALID_REQUEST。

cURL：文字可編輯的 SVG

curl https://sci-draw.com/api/v1/images/conversions \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: figure-12-svg-editable' \
  -F 'image=@figure.png;type=image/png' \
  -F 'format=svg' \
  -F 'vector_mode=editable_text'

JavaScript

const form = new FormData();
form.set('image', file);
form.set('format', 'svg');
form.set('vector_mode', 'full_vector');
const response = await fetch('https://sci-draw.com/api/v1/images/conversions', {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/conversions",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"format": "svg", "vector_mode": "full_vector"},
    )

要使用第二種 SVG 能力，請指定 vector_mode=full_vector。任務成功後， result.files[0] 會提供 format、mime_type 與下載網址。

VSDX (Visio)

網頁版還可以把圖表圖片重建為可編輯的 Microsoft Visio（VSDX）檔案——形狀、連線、文字都會變成可移動的原生物件。該功能位於圖片轉換工具和 AI 繪圖編輯器中，不透過本 API 提供。

如需在自己的流程中程式化轉換 VSDX：該功能由 LayerBack 提供支援，LayerBack 有專門的圖轉 VSDX REST API，參見 LayerBack API 文件。