---
seo_title: WebP zu PNG API: WebP-Bilder in PNG umwandeln | EnConvert
meta_desc: Wandle WebP mit einer REST API in PNG um. POST /v1/convert/webp-to-png erhält Transparenz, liefert verlustfreies PNG als Rohdaten oder presigned Download-URL.
keywords: webp in png umwandeln api, webp zu png konverter, webp png konvertieren online, webp zu png mit transparenz, webp in png konvertieren python, webp zu png node js, verlustfreie webp png konvertierung, bildkonvertierung api png
---

# WebP zu PNG API

Die WebP zu PNG API wandelt ein WebP-Bild mit einer einzigen Anfrage an `POST /v1/convert/webp-to-png` in das PNG-Format um. Lade eine `.webp`-Datei als multipart/form-data hoch und erhalte ein verlustfreies PNG als Rohdaten, oder setze `direct_download=false`, um JSON-Metadaten mit einer presigned Download-URL zu erhalten. Transparenz im WebP bleibt im PNG-Output erhalten.

---

## Endpoint

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

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

**Akzeptierte Eingabe:** `.webp`-Dateien

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

---

## 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 `.png` 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

- Verwendet **Pillow** für die direkte Formatkonvertierung
- Falls das WebP einen Alphakanal besitzt, bleibt dieser im PNG-Output **erhalten**
- Der PNG-Output verwendet verlustfreie Kompression
- Andere Modi als RGBA/RGB werden in RGBA umgewandelt


---

## Antwort

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

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

Gibt rohe Bilddaten zurück.

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

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

---

## Codebeispiele

### Python

```python
import requests

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

with open("image_20260405_123456789.png", "wb") as out:
    out.write(response.content)
```

### Node.js

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

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

fs.writeFileSync("image_20260405_123456789.png", Buffer.from(await response.arrayBuffer()));
```

### PHP

```php
$ch = curl_init("https://api.enconvert.com/v1/convert/webp-to-png");
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.png", $output);
```

### Go

```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-png", 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 WebP mit einer REST API in PNG?

Sende eine `POST`-Anfrage an `/v1/convert/webp-to-png` mit deiner `.webp`-Datei in einem `multipart/form-data`-Body, authentifiziert über `X-API-Key` oder ein JWT-`Authorization: Bearer`-Token. Das konvertierte PNG wird standardmäßig als rohe Bilddaten zurückgegeben.

### Bleibt die Transparenz bei der Konvertierung von WebP zu PNG erhalten?

Ja. Falls das WebP einen Alphakanal besitzt, bleibt dieser im PNG-Output erhalten; andere Modi als RGBA/RGB werden zuvor in RGBA umgewandelt.

### Ist der PNG-Output verlustfrei?

Ja. Der PNG-Output verwendet verlustfreie Kompression, und die Konvertierung wird von Pillow durchgeführt.

### Kann ich eine Download-URL statt roher PNG-Daten erhalten?

Ja. Setze `direct_download=false`, und die API gibt JSON-Metadaten mit `presigned_url`, `filename`, `file_size` und `conversion_time_seconds` zurück.

### Warum gibt die API 400 Bad Request zurück?

Ein `400 Bad Request` bedeutet, dass die hochgeladene Datei keine `.webp`-Datei ist oder die Konvertierung fehlgeschlagen ist, weil die Datei beschädigt oder nicht unterstützt wird.