Bildkonvertierung

POST /api/v1/images/conversions nimmt multipart/form-data entgegen. Erforderlicher Scope: images:convert.

Formularfelder

Feld	Typ	Pflicht	Standard	Regeln
`image`	file	ja	—	PNG, JPEG oder WebP; maximal 10 MiB und 40 Millionen dekodierte Pixel
`format`	string	ja	—	`svg`, `pptx`, `png`, `pdf` oder `tiff`
`vector_mode`	string	nein	`editable_text`	nur für SVG
`dpi`	string	nein	`300`	`300`, `600` oder `1000`; nur für PNG, PDF und TIFF

Beide SVG-Modi

Beide SVG-Optionen sind implementiert und über denselben Endpunkt verfügbar:

`vector_mode`	Ergebnis	Credits
`editable_text`	SVG mit editierbarem Text, wo möglich	10
`full_vector`	vollständig vektorisierte SVG-Ausgabe	15

Die Namen beschreiben Ausgabe-Eigenschaften. Das Capability-Routing verwaltet SciDraw AI; es ist nicht Teil des öffentlichen Vertrags.

Weitere Formate und Credits

Format	Option	Credits
`pptx`	—	10
`png`, `pdf`, `tiff`	`dpi=300`	5
`png`, `pdf`, `tiff`	`dpi=600`	10
`png`, `pdf`, `tiff`	`dpi=1000`	15

full_vector für ein Nicht-SVG-Format oder eine abweichende DPI für SVG bzw. PPTX führt zu 400 INVALID_REQUEST.

cURL: SVG mit editierbarem Text

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

Für die zweite SVG-Variante verwenden Sie vector_mode=full_vector. Bei Erfolg nennt result.files[0] des Jobs format, mime_type und die Download-URL.

Die Web-App kann Diagrammbilder außerdem als editierbare Microsoft-Visio-Dateien (VSDX) nachbauen — Formen, Verbinder und Text werden zu nativen, verschiebbaren Objekten. Diese Option findet sich im Bild-Konverter und im AI-Drawing-Editor; über diese API wird sie nicht angeboten.

VSDX-Konvertierung in der eigenen Pipeline? Die Funktion wird von LayerBack bereitgestellt, das eine eigene REST-API für die Konvertierung von Diagrammbildern nach VSDX bietet — siehe die LayerBack-API-Dokumentation.