WebP zu SVG API#
Konvertiere WebP mit dem Endpoint POST /v1/convert/webp-to-svg in SVG. Dieser bettet ein WebP-Bild in einen SVG-Wrapper ein. Das WebP wird zunächst zu PNG dekodiert, dann base64-kodiert und als Daten-URI innerhalb eines SVG-<image>-Elements platziert. Dies ist keine Vektorisierung. Antworten liefern standardmäßig die rohen SVG-Daten, oder JSON-Metadaten mit einer presigned Download-URL, wenn direct_download=false gesetzt ist.
Endpoint#
POST /v1/convert/webp-to-svg
Content-Type: multipart/form-data
Akzeptierte Eingabe: .webp-Dateien
Ausgabeformat: .svg (image/svg+xml)
Authentifizierung#
Erfordert entweder einen privaten API-Schlüssel oder ein JWT-Token von einem öffentlichen Schlüssel.
X-API-Key: sk_your_private_key
Oder:
Authorization: Bearer <jwt_token>
Request-Parameter#
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
file |
file | Ja | -- | Die zu konvertierende .webp-Bilddatei. |
output_filename |
string |
Nein | Eingabedateiname | Benutzerdefinierter Ausgabedateiname. Die Endung .svg wird automatisch hinzugefügt. |
direct_download |
boolean |
Nein | true |
Bei true werden rohe Bilddaten zurückgegeben. Bei false werden JSON-Metadaten mit einer presigned Download-URL zurückgegeben. |
Details zur Konvertierung#
- Das WebP wird zunächst mit Pillow zu PNG dekodiert, dann base64-kodiert und eingebettet in ein SVG-
<image>-Element - Die SVG-Abmessungen und die viewBox entsprechen den Pixel-Abmessungen des Originalbilds
- Die Transparenz bleibt in den eingebetteten PNG-Daten erhalten
- Dies ist KEINE Vektorisierung -- der Output enthält die vollständigen Rasterbilddaten, keine Vektorpfade
Antwort#
Direkter Download (direct_download=true, Standard)#
HTTP 200 OK
Content-Type: image/svg+xml
Content-Disposition: inline; filename="image_20260405_123456789.svg"
Gibt rohe Bilddaten zurück.
Metadaten-Antwort (direct_download=false)#
{
"presigned_url": "https://spaces.example.com/...",
"object_key": "env/files/{project_id}/webp-to-svg/image_20260405_123456789.svg",
"filename": "image_20260405_123456789.svg",
"file_size": 45678,
"conversion_time_seconds": 0.5
}
Codebeispiele#
Python#
import requests
with open("image.webp", "rb") as f:
response = requests.post(
"https://api.enconvert.com/v1/convert/webp-to-svg",
headers={"X-API-Key": "sk_your_private_key"},
files={"file": ("image.webp", f)}
)
with open("image_20260405_123456789.svg", "wb") as out:
out.write(response.content)
Node.js#
const form = new FormData();
form.append("file", fs.createReadStream("image.webp"));
const response = await fetch("https://api.enconvert.com/v1/convert/webp-to-svg", {
method: "POST",
headers: { "X-API-Key": "sk_your_private_key" },
body: form
});
fs.writeFileSync("image_20260405_123456789.svg", Buffer.from(await response.arrayBuffer()));
PHP#
$ch = curl_init("https://api.enconvert.com/v1/convert/webp-to-svg");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["X-API-Key: sk_your_private_key"],
CURLOPT_POSTFIELDS => ["file" => new CURLFile("image.webp")]
]);
$output = curl_exec($ch);
curl_close($ch);
file_put_contents("image_20260405_123456789.svg", $output);
Go#
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", "image.webp")
file, _ := os.Open("image.webp")
io.Copy(part, file)
writer.Close()
req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/webp-to-svg", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-API-Key", "sk_your_private_key")
resp, _ := http.DefaultClient.Do(req)
Fehlerantworten#
| Status | Bedingung |
|---|---|
400 Bad Request |
Datei ist keine .webp-Datei |
400 Bad Request |
Bildkonvertierung fehlgeschlagen (beschädigte oder nicht unterstützte Datei) |
401 Unauthorized |
Fehlender oder ungültiger API-Schlüssel / JWT-Token |
402 Payment Required |
Monatliches Ops-Kontingent aufgebraucht |
402 Payment Required |
Speicherlimit erreicht |
413 Payload Too Large |
Datei überschreitet die maximale Dateigröße des Plans |
Limits#
| Limit | Wert |
|---|---|
| Maximale Dateigröße | Abhängig vom Plan (Founding: 5 MB) |
| Ausgabequalität | Maximum (nicht konfigurierbar) |
| Monatliche Konvertierungen | Abhängig vom Plan |
Häufig gestellte Fragen#
Wie konvertiere ich ein WebP-Bild mit einer REST API in SVG?#
Sende eine multipart/form-data-POST-Anfrage an /v1/convert/webp-to-svg mit der .webp-Datei im Feld file, authentifiziert über X-API-Key oder ein Bearer-JWT. Du erhältst die SVG-Daten direkt zurück, oder setze direct_download=false für JSON mit einer presigned Download-URL.
Vektorisiert die WebP-zu-SVG-Konvertierung das Bild?#
Nein. Der Endpoint dekodiert das WebP mit Pillow zu PNG und base64-kodiert es anschließend als Daten-URI innerhalb eines SVG-<image>-Elements. Der Output enthält die vollständigen Rasterbilddaten, keine nachgezeichneten Vektorpfade.
Bleibt die Transparenz bei der Konvertierung von WebP zu SVG erhalten?#
Ja. Die Transparenz bleibt in den eingebetteten PNG-Daten erhalten, und die SVG-Abmessungen und die viewBox entsprechen den Pixel-Abmessungen des Originalbilds.
Warum gibt der WebP-zu-SVG-Endpoint einen 400-Fehler zurück?#
400 Bad Request wird zurückgegeben, wenn die hochgeladene Datei keine .webp-Datei ist, oder wenn die Konvertierung fehlschlägt, weil die Datei beschädigt oder nicht unterstützt wird.