API SVG vers WebP#

Convertissez du SVG en WebP avec l'endpoint POST /v1/convert/svg-to-webp. Le SVG est rendu via CairoSVG, puis encodé en WebP à qualité maximale avec la transparence préservée. Les paramètres optionnels width et height définissent les dimensions de sortie en pixels. Les réponses renvoient des octets WebP bruts par défaut, ou des métadonnées JSON avec une URL de téléchargement présignée lorsque direct_download=false.

Endpoint#

POST /v1/convert/svg-to-webp

Type de contenu : multipart/form-data

Entrée acceptée : fichiers .svg

Format de sortie : .webp (image/webp)

Authentification#

Nécessite soit une clé API privée, soit un jeton JWT provenant 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 en PNG intermédiaire, puis Pillow pour l'encodage WebP
• Par défaut, la résolution de sortie est déterminée par les attributs width, height et viewBox propres au SVG ; les paramètres de requête width/height la remplacent
• La transparence est préservée dans le WebP de sortie
• La qualité de sortie est réglée au maximum (100)

Réponse#

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

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

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-webp/icon_20260405_123456789.webp",
    "filename": "icon_20260405_123456789.webp",
    "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-webp",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("icon.svg", f)}
    )

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

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

PHP#

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

Envoyez une requête POST multipart/form-data à /v1/convert/svg-to-webp avec le SVG dans le champ file, authentifiée via X-API-Key ou un Bearer JWT. La réponse renvoie des octets WebP bruts par défaut, ou définissez direct_download=false pour recevoir du JSON avec une URL de téléchargement présignée.

La conversion de SVG en WebP préserve-t-elle la transparence ?#

Oui. La transparence du SVG est préservée dans le WebP de sortie.

Comment obtenir un WebP en plus haute résolution à partir de mon 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.

Puis-je définir la qualité du WebP sur cet endpoint ?#

Non. La qualité de sortie est fixée au maximum (100) et n'est pas configurable.