API 文件API 文件
影像轉換
將影像轉為 SVG、PPTX、PNG、PDF 或 TIFF
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
Python
with open("figure.png", "rb") as image:
response = requests.post(
"https://sci-draw.com/api/v1/images/conversions",
headers={"Authorization": f"Bearer
要使用第二種 SVG 能力，請指定 vector_mode=full_vector。任務成功後，
result.files[0] 會提供 format、mime_type 與下載網址。