Конвертация изображений

Преобразование изображений в SVG, PPTX, PNG, PDF или TIFF

POST /api/v1/images/conversions принимает multipart/form-data. Требуемое право: images:convert.

Поля формы

Поле	Тип	Обязательно	По умолчанию	Правила
`image`	file	да	—	PNG, JPEG или WebP; не более 10 МиБ и 40 млн пикселей после декодирования
`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

Передача full_vector для формата, отличного от SVG, или нестандартного DPI для SVG либо PPTX даёт 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 и URL для скачивания.

Веб-приложение также умеет пересобирать изображения диаграмм в редактируемые файлы Microsoft Visio (VSDX): фигуры, соединители и текст становятся нативными перемещаемыми объектами. Эта опция доступна в конвертере изображений и редакторе AI Drawing; через данный API она не предоставляется.

Нужна конвертация в VSDX в собственном пайплайне? Функция работает на базе LayerBack, у которого есть отдельный REST API для конвертации изображений диаграмм в VSDX — см. документацию API LayerBack.