---
seo_title: JPEG zu SVG API: JPG programmatisch einbetten | EnConvert
meta_desc: Bette ein JPEG mit POST /v1/convert/jpeg-to-svg in ein SVG ein. Die API kodiert das Bild base64 in ein SVG-image-Element: ein Raster-Wrapper, keine Vektorisierung.
keywords: jpeg in svg umwandeln api, jpg zu svg api, jpg in svg einbetten, base64 bild in svg api, jpeg zu svg konverter api, raster bild svg wrapper, jpg programmatisch konvertieren
---

# JPEG zu SVG API

Wandle ein JPEG mit `POST /v1/convert/jpeg-to-svg` in das SVG-Format um: Der Endpunkt kodiert das JPEG base64 und bettet es als Daten-URI in ein SVG-`<image>`-Element ein. Das ist keine Vektorisierung. Die Ausgabe enthält das vollständige Rasterbild in einem SVG-Container, nützlich für Workflows, die SVG erfordern, aber eingebetteten Rasterinhalt akzeptieren. Die Antwort liefert entweder rohe Bytes zum direkten Download oder JSON-Metadaten mit einer presigned Download-URL.

---

## Endpunkt

```
POST /v1/convert/jpeg-to-svg
```

**Content-Type:** `multipart/form-data`

**Akzeptierte Eingabe:** `.jpeg or .jpg`-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>
```

---

## Anfrageparameter

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|-----------|------|----------|---------|-------------|
| `file` | Datei | Ja | -- | Die zu konvertierende `.jpeg or .jpg`-Bilddatei. |
| `output_filename` | `string` | Nein | Eingabedateiname | Benutzerdefinierter Ausgabedateiname. Die Endung `.svg` wird automatisch hinzugefügt. |
| `direct_download` | `boolean` | Nein | `true` | Bei `true` werden rohe Bild-Bytes zurückgegeben. Bei `false` werden JSON-Metadaten mit einer presigned Download-URL zurückgegeben. |

---

## Details zur Konvertierung

- Das JPEG wird **base64-kodiert und eingebettet** als Daten-URI in ein SVG-`<image>`-Element
- Die SVG-Abmessungen und das viewBox entsprechen den Pixelabmessungen des Originalbilds
- **Das ist KEINE Vektorisierung** -- die Ausgabe enthält die vollständigen Rasterbilddaten, keine Vektorpfade
- Nützlich für Workflows, die das SVG-Format erfordern, aber eingebetteten Rasterinhalt akzeptieren

<div class="alert alert-warning">
<strong>Keine Vektorisierung:</strong> Dieser Endpunkt bettet das Rasterbild in einen SVG-Container ein. Er zeichnet das Bild nicht nach und wandelt es nicht in Vektorpfade um. Die Ausgabedatei ist aufgrund der base64-Kodierung größer als die Eingabe (~33 % Overhead).
</div>

---

## Antwort

### Direkter Download (`direct_download=true`, Standard)

```
HTTP 200 OK
Content-Type: image/svg+xml
Content-Disposition: inline; filename="photo_20260405_123456789.svg"
```

Gibt rohe Bild-Bytes zurück.

### Metadaten-Antwort (`direct_download=false`)

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

---

## Codebeispiele

### Python

```python
import requests

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

with open("photo_20260405_123456789.svg", "wb") as out:
    out.write(response.content)
```

### Node.js

```javascript
const form = new FormData();
form.append("file", fs.createReadStream("photo.jpg"));

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

fs.writeFileSync("photo_20260405_123456789.svg", Buffer.from(await response.arrayBuffer()));
```

### PHP

```php
$ch = curl_init("https://api.enconvert.com/v1/convert/jpeg-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("photo.jpg")]
]);
$output = curl_exec($ch);
curl_close($ch);
file_put_contents("photo_20260405_123456789.svg", $output);
```

### Go

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

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/jpeg-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 `.jpeg or .jpg`-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 JPG mit einer REST-API in SVG?

Sende eine `multipart/form-data`-POST-Anfrage an `/v1/convert/jpeg-to-svg` mit deiner `.jpeg`- oder `.jpg`-Datei im Feld `file`, authentifiziert über `X-API-Key` oder ein `Bearer`-JWT-Token. Die API liefert ein SVG mit deinem base64-eingebetteten Bild in einem `<image>`-Element.

### Vektorisiert die JPEG-zu-SVG-API mein Bild?

Nein. Dieser Endpunkt zeichnet das Bild nicht nach und wandelt es nicht in Vektorpfade um. Er bettet das Raster-JPEG als base64-Daten-URI in einen SVG-Container ein. Die SVG-Abmessungen und das viewBox entsprechen den Pixelabmessungen des Originalbilds.

### Warum ist die SVG-Ausgabe größer als meine JPEG-Eingabe?

Die base64-Kodierung fügt etwa 33 % Overhead hinzu, daher ist die Ausgabedatei größer als die Eingabe, da sie die vollständigen Rasterbilddaten als Text kodiert enthält.

### Kann ich eine Download-URL statt roher Datei-Bytes erhalten?

Ja. Setze `direct_download=false`, und die API liefert JSON-Metadaten einschließlich `presigned_url`, `object_key`, `filename`, `file_size` und `conversion_time_seconds`.