API de SVG a PNG#

La API de SVG a PNG rasteriza una imagen SVG a formato PNG con una sola solicitud a POST /v1/convert/svg-to-png. Sube un archivo .svg como multipart/form-data y el SVG se renderiza a píxeles usando CairoSVG, conservando la transparencia en la salida PNG. Los parámetros opcionales width y height establecen las dimensiones de salida en píxeles. La respuesta son bytes PNG sin procesar de forma predeterminada, o metadatos JSON con una URL de descarga prefirmada cuando direct_download=false.

Endpoint#

POST /v1/convert/svg-to-png

Content-Type: multipart/form-data

Entrada aceptada: archivos .svg

Formato de salida: .png (image/png)

Autenticación#

Requiere una clave de API privada o un token JWT de una clave pública.

X-API-Key: sk_your_private_key

O:

Authorization: Bearer <jwt_token>

Parámetros de la solicitud#

Detalles de la conversión#

• Usa CairoSVG para renderizar el SVG directamente a PNG
• De forma predeterminada, la resolución de salida la determinan los propios atributos width, height y viewBox del SVG (96 DPI por defecto); los parámetros width/height de la solicitud la sobrescriben
• La transparencia se conserva en la salida PNG
• Si el SVG no tiene dimensiones explícitas, CairoSVG usa sus propios valores predeterminados

Respuesta#

Descarga directa (direct_download=true, predeterminado)#

HTTP 200 OK
Content-Type: image/png
Content-Disposition: inline; filename="icon_20260405_123456789.png"

Devuelve los bytes de la imagen sin procesar.

Respuesta con metadatos (direct_download=false)#

{
    "presigned_url": "https://spaces.example.com/...",
    "object_key": "env/files/{project_id}/svg-to-png/icon_20260405_123456789.png",
    "filename": "icon_20260405_123456789.png",
    "file_size": 45678,
    "conversion_time_seconds": 0.5
}

Ejemplos de código#

Python#

import requests

with open("icon.svg", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/svg-to-png",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("icon.svg", f)}
    )

with open("icon_20260405_123456789.png", "wb") as out:
    out.write(response.content)

Node.js#

const form = new FormData();
form.append("file", fs.createReadStream("icon.svg"));

const response = await fetch("https://api.enconvert.com/v1/convert/svg-to-png", {
    method: "POST",
    headers: { "X-API-Key": "sk_your_private_key" },
    body: form
});

fs.writeFileSync("icon_20260405_123456789.png", Buffer.from(await response.arrayBuffer()));

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/svg-to-png");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: sk_your_private_key"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("icon.svg")]
]);
$output = curl_exec($ch);
curl_close($ch);
file_put_contents("icon_20260405_123456789.png", $output);

Go#

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", "icon.svg")
file, _ := os.Open("icon.svg")
io.Copy(part, file)
writer.Close()

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/svg-to-png", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-API-Key", "sk_your_private_key")
resp, _ := http.DefaultClient.Do(req)

Respuestas de error#

Límites#

Preguntas frecuentes#

¿Cómo rasterizo un SVG a PNG con una API REST?#

Envía una solicitud POST a /v1/convert/svg-to-png con tu archivo .svg como multipart/form-data, autenticada mediante X-API-Key o un token JWT Authorization: Bearer. CairoSVG renderiza el SVG directamente a PNG y devuelve los bytes sin procesar.

¿Cómo controlo la resolución de salida del PNG?#

Pasa los campos de formulario width y/o height (en píxeles, hasta 10000 por dimensión). Una sola dimensión escala la salida proporcionalmente según la relación de aspecto del SVG; ambas dimensiones fijan el tamaño exacto de salida. Sin ellos, los propios atributos width, height y viewBox del SVG deciden la resolución.

¿Se conserva la transparencia al convertir SVG a PNG?#

Sí. La transparencia se conserva en la salida PNG.

¿Qué ocurre si mi SVG no tiene dimensiones explícitas?#

Si el SVG no tiene dimensiones explícitas, CairoSVG usa sus propios valores predeterminados para determinar el tamaño de salida.

¿Puedo obtener una URL de descarga prefirmada en lugar de los bytes PNG sin procesar?#

Sí. Configura direct_download=false y la API devuelve JSON con presigned_url, filename, file_size y conversion_time_seconds.