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 管理，不属于公开契约。

其他格式与积分

图片编辑

使用自然语言指令编辑上传图片

图表生成

从数据表生成期刊风格的统计图表

目录

两种 SVG 方式

其他格式与积分

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'

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,
});

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"},
    )