API-Dokumentation

Bildkonvertierung

Bilder nach SVG, PPTX, PNG, PDF oder TIFF konvertieren

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.

Bildbearbeitung

Ein hochgeladenes Bild mit Anweisungen in natürlicher Sprache bearbeiten

Jobs und begrenztes Warten

Asynchrone Arbeit abfragen und bereinigte Ergebnisse lesen

Inhaltsverzeichnis

Formularfelder

Beide SVG-Modi

Weitere Formate und Credits

cURL: SVG mit editierbarem Text

JavaScript

Python

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

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