Conversion d'images

POST /api/v1/images/conversions accepte multipart/form-data. Portée requise : images:convert.

Champs du formulaire

Champ	Type	Obligatoire	Défaut	Règles
`image`	file	oui	—	PNG, JPEG ou WebP ; 10 Mio et 40 millions de pixels décodés au maximum
`format`	string	oui	—	`svg`, `pptx`, `png`, `pdf` ou `tiff`
`vector_mode`	string	non	`editable_text`	SVG uniquement
`dpi`	string	non	`300`	`300`, `600` ou `1000` ; PNG, PDF et TIFF uniquement

Les deux modes SVG

Les deux options SVG sont implémentées et disponibles via le même point de terminaison :

`vector_mode`	Résultat	Crédits
`editable_text`	SVG au texte modifiable lorsque c'est possible	10
`full_vector`	sortie SVG entièrement vectorisée	15

Ces noms décrivent des capacités de sortie. L'acheminement des capacités est géré par SciDraw AI et ne fait pas partie du contrat public.

Autres formats et crédits

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

Envoyer full_vector pour un format autre que SVG, ou une DPI non par défaut pour SVG ou PPTX, renvoie 400 INVALID_REQUEST.

cURL : SVG à texte modifiable

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

Utilisez vector_mode=full_vector pour la seconde capacité SVG. En cas de succès, result.files[0] du job indique format, mime_type et l'URL de téléchargement.

L’application web peut aussi reconstruire des images de diagrammes en fichiers Microsoft Visio (VSDX) modifiables — formes, connecteurs et texte deviennent des objets natifs déplaçables. Cette option se trouve dans le convertisseur d’images et l’éditeur AI Drawing ; elle n’est pas exposée via cette API.

Besoin de conversion VSDX dans votre propre pipeline ? La fonctionnalité s’appuie sur LayerBack, qui propose une API REST dédiée à la conversion d’images de diagrammes en VSDX — voir la documentation de l’API LayerBack.