LogoLogoДокументация API
LogoLogoДокументация API
Главная страница
ОбзорАутентификация и идемпотентностьГенерация изображенийРедактирование изображенийКонвертация изображенийЗадачи и ограниченное ожиданиеКредитыОшибкиОграничения частоты и параллелизмаИстория изменений API
Документация API

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

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

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

Поля формы

ПолеТипОбязательноПо умолчаниюПравила
imagefileда—PNG, JPEG или WebP; не более 10 МиБ и 40 млн пикселей после декодирования
formatstringда—svg, pptx, png, pdf или tiff
vector_modestringнетeditable_textтолько для SVG
dpistringнет300300, 600 или 1000; только для PNG, PDF и TIFF

Два режима SVG

Оба варианта SVG реализованы и доступны через один и тот же эндпоинт:

vector_modeРезультатКредиты
editable_textSVG с редактируемым текстом там, где это возможно10
full_vectorполностью векторизованный SVG15

Эти названия описывают свойства результата. Маршрутизацией возможностей управляет SciDraw AI, и она не входит в публичный контракт.

Редактирование изображений

Правка загруженного изображения по указаниям на естественном языке

Задачи и ограниченное ожидание

Опрос асинхронной работы и чтение очищенных результатов

Оглавление

Поля формы
Два режима SVG
Другие форматы и кредиты
cURL: SVG с редактируемым текстом
JavaScript
Python

Другие форматы и кредиты

ФорматПараметрКредиты
pptx—10
png, pdf, tiffdpi=3005
png, pdf, tiffdpi=60010
png, pdf, tiffdpi=100015

Передача 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 для скачивания.