API SVG vers JPEG#

Rastérisez des images SVG en JPEG de façon programmatique avec POST /v1/convert/svg-to-jpeg. L'endpoint rend le SVG en pixels à l'aide de CairoSVG, compose les zones transparentes sur un fond blanc, et renvoie un JPEG. Les paramètres optionnels width et height définissent les dimensions de sortie en pixels. Les réponses renvoient soit les octets bruts de l'image pour un téléchargement direct, soit des métadonnées JSON avec une URL de téléchargement présignée.

Endpoint#

POST /v1/convert/svg-to-jpeg

Content-Type: multipart/form-data

Entrée acceptée : fichiers .svg

Format de sortie : .jpeg (image/jpeg)

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 vers un PNG intermédiaire, puis Pillow pour convertir en JPEG
• 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
• Si le SVG n'a pas de dimensions explicites, CairoSVG applique ses propres valeurs par défaut
• Les zones transparentes sont composées sur un fond blanc
• La qualité de sortie est fixée au maximum (100)

Réponse#

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

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

Renvoie les octets bruts de l'image.

Réponse avec métadonnées (direct_download=false)#

{
    "presigned_url": "https://spaces.example.com/...",
    "object_key": "env/files/{project_id}/svg-to-jpeg/icon_20260405_123456789.jpeg",
    "filename": "icon_20260405_123456789.jpeg",
    "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-jpeg",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("icon.svg", f)}
    )

with open("icon_20260405_123456789.jpeg", "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-jpeg", {
    method: "POST",
    headers: { "X-API-Key": "sk_your_private_key" },
    body: form
});

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

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/svg-to-jpeg");
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.jpeg", $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-jpeg", 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 convertir un SVG en JPG avec une API REST ?#

Envoyez une requête POST multipart/form-data à /v1/convert/svg-to-jpeg avec votre fichier .svg dans le champ file, authentifiée via X-API-Key ou un jeton JWT Bearer. CairoSVG rend le SVG vers un PNG intermédiaire, puis Pillow le convertit en JPEG.

Comment contrôler la résolution de sortie lors de la rastérisation d'un SVG ?#

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.

Qu'advient-il des zones transparentes du SVG ?#

Le JPEG ne prend pas en charge la transparence, les zones transparentes sont donc composées sur un fond blanc dans le résultat.

Puis-je obtenir une URL de téléchargement plutôt que les octets bruts de l'image ?#

Oui. Définissez direct_download=false et l'API renvoie des métadonnées JSON incluant presigned_url, object_key, filename, file_size et conversion_time_seconds.