API SVG vers PNG#

L'API SVG vers PNG rastérise une image SVG au format PNG en une seule requête vers POST /v1/convert/svg-to-png. Envoyez un fichier .svg en multipart/form-data et le SVG est rendu en pixels à l'aide de CairoSVG, la transparence étant préservée dans la sortie PNG. Les paramètres optionnels width et height définissent les dimensions de sortie en pixels. La réponse est constituée d'octets PNG bruts par défaut, ou de métadonnées JSON avec une URL de téléchargement présignée lorsque direct_download=false.

Point de terminaison#

POST /v1/convert/svg-to-png

Content-Type : multipart/form-data

Entrée acceptée : fichiers .svg

Format de sortie : .png (image/png)

Authentification#

Nécessite soit une clé API privée, soit un jeton JWT issu d'une clé publique.

X-API-Key: sk_your_private_key

Ou :

Authorization: Bearer <jwt_token>

Paramètres de la requête#

Détails de la conversion#

• Utilise CairoSVG pour rendre le SVG directement en PNG
• Par défaut, la résolution de sortie est déterminée par les attributs width, height et viewBox propres au SVG (96 DPI par défaut) ; les paramètres de requête width/height la remplacent
• La transparence est préservée dans la sortie PNG
• Si le SVG ne comporte pas de dimensions explicites, CairoSVG utilise ses propres valeurs par défaut

Réponse#

Téléchargement direct (direct_download=true, par défaut)#

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

Renvoie les octets bruts de l'image.

Réponse de métadonnées (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
}

Exemples de code#

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)

Réponses d'erreur#

Limites#

Questions fréquentes#

Comment rastériser un SVG en PNG avec une API REST ?#

Envoyez une requête POST à /v1/convert/svg-to-png avec votre fichier .svg en multipart/form-data, authentifiée via X-API-Key ou un jeton JWT Authorization: Bearer. CairoSVG rend le SVG directement en PNG et renvoie les octets bruts.

Comment contrôler la résolution de sortie du PNG ?#

Transmettez les champs de formulaire width et/ou height (en pixels, jusqu'à 10000 par dimension). Une seule dimension redimensionne la sortie proportionnellement selon le rapport d'aspect du SVG ; les deux dimensions définissent la taille de sortie exacte. Sans ces champs, les attributs width, height et viewBox propres au SVG déterminent la résolution.

La transparence est-elle préservée lors de la conversion de SVG en PNG ?#

Oui. La transparence est préservée dans la sortie PNG.

Que se passe-t-il si mon SVG n'a pas de dimensions explicites ?#

Si le SVG ne comporte pas de dimensions explicites, CairoSVG utilise ses propres valeurs par défaut pour déterminer la taille de sortie.

Puis-je obtenir une URL de téléchargement présignée au lieu des octets PNG bruts ?#

Oui. Définissez direct_download=false et l'API renvoie du JSON avec presigned_url, filename, file_size et conversion_time_seconds.