webp-to-png

Convert a WebP image to PNG format. Transparency is preserved. Produces a lossless PNG.

Endpoint

POST /v1/convert/webp-to-png

Content-Type: multipart/form-data

Accepted input: .webp files

Output format: .png (image/png)

Authentication

Requires either a private API key or a JWT token from a public key.

X-API-Key: sk_live_your_private_key

Or:

Authorization: Bearer <jwt_token>

Request Parameters

Parameter	Type	Required	Default	Description
`file`	file	Yes	--	The `.webp` image file to convert.
`output_filename`	`string`	No	Input filename	Custom output filename. The `.png` extension is added automatically.
`direct_download`	`boolean`	No	`true`	When `true`, returns raw image bytes. When `false`, returns JSON metadata with a presigned download URL.

Conversion Details

Uses Pillow for direct format conversion
If the WebP has an alpha channel, it is preserved in the PNG output
PNG output uses lossless compression
Non-RGBA/RGB modes are converted to RGBA

Response

Direct Download (`direct_download=true`, default)

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

Returns raw image bytes.

Metadata Response (`direct_download=false`)

{
    "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
}

Code Examples

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_live_your_private_key"},
        files={"file": ("image.webp", f)}
    )

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

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

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_live_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

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_live_your_private_key")
resp, _ := http.DefaultClient.Do(req)

Error Responses

Status	Condition
`400 Bad Request`	File is not a `.webp` file
`400 Bad Request`	Image conversion failed (corrupt or unsupported file)
`401 Unauthorized`	Missing or invalid API key / JWT token
`402 Payment Required`	Monthly conversion limit reached
`402 Payment Required`	Storage limit reached
`413 Payload Too Large`	File exceeds plan's maximum file size

Limits

Limit	Value
Max file size	Plan-dependent (Free: 5 MB)
Output quality	Maximum (not configurable)
Monthly conversions	Plan-dependent

API Documentation Beta