Conversión de imágenes

POST /api/v1/images/conversions acepta multipart/form-data. Ámbito requerido: images:convert.

Campos del formulario

Campo	Tipo	Obligatorio	Predeterminado	Reglas
`image`	file	sí	—	PNG, JPEG o WebP; máximo 10 MiB y 40 millones de píxeles decodificados
`format`	string	sí	—	`svg`, `pptx`, `png`, `pdf` o `tiff`
`vector_mode`	string	no	`editable_text`	solo SVG
`dpi`	string	no	`300`	`300`, `600` o `1000`; solo PNG, PDF y TIFF

Los dos modos SVG

Las dos opciones de SVG están implementadas y se ofrecen en el mismo endpoint:

`vector_mode`	Resultado	Créditos
`editable_text`	SVG con texto editable siempre que sea posible	10
`full_vector`	salida SVG totalmente vectorizada	15

Los nombres describen capacidades de salida. El enrutado de capacidades lo gestiona SciDraw AI y no forma parte del contrato público.

Otros formatos y créditos

Formato	Opción	Créditos
`pptx`	—	10
`png`, `pdf`, `tiff`	`dpi=300`	5
`png`, `pdf`, `tiff`	`dpi=600`	10
`png`, `pdf`, `tiff`	`dpi=1000`	15

Enviar full_vector para un formato que no sea SVG, o un DPI distinto del predeterminado para SVG o PPTX, devuelve 400 INVALID_REQUEST.

cURL: SVG con texto editable

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

Usa vector_mode=full_vector para la segunda capacidad de SVG. En un trabajo correcto, result.files[0] indica format, mime_type y su URL de descarga.

La aplicación web también puede reconstruir imágenes de diagramas como archivos de Microsoft Visio (VSDX) editables: formas, conectores y texto se convierten en objetos nativos movibles. Esta opción está en el conversor de imágenes y en el editor AI Drawing; no se expone a través de esta API.

¿Necesitas conversión a VSDX en tu propio pipeline? La función está impulsada por LayerBack, que ofrece una API REST dedicada para convertir imágenes de diagramas a VSDX; consulta la documentación de la API de LayerBack.