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 和下载地址。