Conversione di immagini

POST /api/v1/images/conversions accetta multipart/form-data. Ambito richiesto: images:convert.

Campi del modulo

Le due modalità SVG

Entrambe le opzioni SVG sono implementate e disponibili sullo stesso endpoint:

I nomi descrivono capacità di output. L'instradamento delle capacità è gestito da SciDraw AI e non fa parte del contratto pubblico.

Altri formati e crediti

Inviare full_vector per un formato diverso da SVG, oppure un DPI non predefinito per SVG o PPTX, restituisce 400 INVALID_REQUEST.

cURL: SVG con testo modificabile

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

Per la seconda capacità SVG usa vector_mode=full_vector. In caso di successo, result.files[0] del job riporta format, mime_type e l'URL di download.

VSDX (Visio)

L’app web può inoltre ricostruire immagini di diagrammi come file Microsoft Visio (VSDX) modificabili: forme, connettori e testo diventano oggetti nativi spostabili. L’opzione si trova nel convertitore di immagini e nell’editor AI Drawing; non è esposta tramite questa API.

Ti serve la conversione VSDX nella tua pipeline? La funzione è basata su LayerBack, che offre una REST API dedicata alla conversione di immagini di diagrammi in VSDX — vedi la documentazione dell’API LayerBack.