LogoLogoDocumentazione API
LogoLogoDocumentazione API
Homepage
PanoramicaAutenticazione e idempotenzaGenerazione di immaginiModifica di immaginiConversione di immaginiGenerazione di graficiJob e attesa limitataCreditiErroriLimiti di frequenza e concorrenzaChangelog dell'API
Documentazione API

Conversione di immagini

Convertire immagini in SVG, PPTX, PNG, PDF o TIFF

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

Campi del modulo

CampoTipoObbligatorioPredefinitoRegole
imagefilesì—PNG, JPEG o WebP; al massimo 10 MiB e 40 milioni di pixel decodificati
formatstringsì—svg, pptx, png, pdf o tiff
vector_modestringnoeditable_textsolo SVG
dpistringno300300, 600 o 1000; solo PNG, PDF e TIFF

Le due modalità SVG

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

vector_modeRisultatoCrediti
editable_textSVG con testo modificabile dove possibile10
full_vectoroutput SVG completamente vettorializzato15

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

Modifica di immagini

Modificare un'immagine caricata con istruzioni in linguaggio naturale

Generazione di grafici

Generare un grafico pronto per la pubblicazione da una tabella di dati

Indice

Campi del modulo
Le due modalità SVG
Altri formati e crediti
cURL: SVG con testo modificabile
JavaScript
Python
VSDX (Visio)

Altri formati e crediti

FormatoOpzioneCrediti
pptx—10
png, pdf, tiffdpi=3005
png, pdf, tiffdpi=60010
png, pdf, tiffdpi=100015

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.