---
seo_title: JPEG-zu-WebP-API: Bilder mit WebP optimieren | EnConvert
meta_desc: Konvertieren Sie JPEG zu WebP mit POST /v1/convert/jpeg-to-webp. WebP-Dateien sind bei gleicher Qualität 25-35 % kleiner als JPEG. Rückgabe als Bytes oder presigned URL.
keywords: jpeg in webp umwandeln api, jpg zu webp api, jpeg programmatisch in webp konvertieren, bildoptimierung webp api, webp konvertierung rest api, bilddateigröße reduzieren api, jpg webp converter api
---

# JPEG-zu-WebP-API

Konvertieren Sie JPEG-Bilder programmatisch mit `POST /v1/convert/jpeg-to-webp` zu WebP. Der Endpunkt akzeptiert einen `.jpeg`- oder `.jpg`-Upload und erzeugt ein hochwertiges WebP mit kleinerer Dateigröße als das entsprechende JPEG. Das ist ein einfacher Bildoptimierungsschritt für Web-Delivery-Pipelines. Die Antwort enthält entweder rohe Bilddaten zum direkten Download oder JSON-Metadaten mit einer presigned Download-URL.

---

## Endpunkt

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

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

**Akzeptierte Eingabe:** `.jpeg or .jpg`-Dateien

**Ausgabeformat:** `.webp` (`image/webp`)

---

## Authentifizierung

Erfordert entweder einen privaten API-Schlüssel oder ein JWT-Token eines öffentlichen Schlüssels.

```
X-API-Key: sk_your_private_key
```

Oder:

```
Authorization: Bearer <jwt_token>
```

---

## Request-Parameter

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|-----------|------|----------|---------|-------------|
| `file` | Datei | Ja | -- | Die zu konvertierende `.jpeg or .jpg`-Bilddatei. |
| `output_filename` | `string` | Nein | Eingabedateiname | Benutzerdefinierter Ausgabedateiname. Die Endung `.webp` wird automatisch angehängt. |
| `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

- Verwendet **Pillow** für die direkte Formatkonvertierung
- Die RGB-Farbdaten des JPEG bleiben in der WebP-Ausgabe erhalten
- Die Ausgabequalität ist auf Maximum (100) eingestellt
- WebP erreicht bei gleicher visueller Qualität in der Regel 25-35 % kleinere Dateigrößen als JPEG


---

## Antwort

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

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

Liefert rohe Bilddaten.

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

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

---

## Code-Beispiele

### Python

```python
import requests

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

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

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

### PHP

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

Senden Sie einen `multipart/form-data`-POST-Request an `/v1/convert/jpeg-to-webp` mit Ihrer `.jpeg`- oder `.jpg`-Datei im Feld `file`, authentifiziert über `X-API-Key` oder ein `Bearer`-JWT-Token. Standardmäßig antwortet die API mit den rohen WebP-Bytes.

### Um wie viel kleiner ist WebP als JPEG?

WebP erreicht bei gleicher visueller Qualität in der Regel 25-35 % kleinere Dateigrößen als JPEG. Dieser Endpunkt konvertiert mit Pillow bei maximaler Qualität (100) und erhält dabei die RGB-Farbdaten des JPEG.

### Kann ich eine Download-URL statt roher Bilddaten erhalten?

Ja. Setzen Sie `direct_download=false`, dann liefert die API JSON-Metadaten mit `presigned_url`, `object_key`, `filename`, `file_size` und `conversion_time_seconds`.

### Kann ich die WebP-Ausgabequalität oder den Dateinamen festlegen?

Die Ausgabequalität ist fest auf Maximum (100) eingestellt und nicht konfigurierbar. Einen benutzerdefinierten Ausgabedateinamen können Sie mit dem Parameter `output_filename` festlegen; die Endung `.webp` wird automatisch angehängt.