jpeg-to-png
Convert a JPEG image to PNG format. Produces a lossless PNG with full color fidelity.
Endpoint
POST /v1/convert/jpeg-to-png
Content-Type: multipart/form-data
Accepted input: .jpeg or .jpg 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 .jpeg or .jpg 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
- JPEG's RGB color data is preserved losslessly in the PNG output
- PNG output uses lossless compression
- Output quality is maximum (lossless)
Response
Direct Download (direct_download=true, default)
HTTP 200 OK
Content-Type: image/png
Content-Disposition: inline; filename="photo_20260405_123456789.png"
Returns raw image bytes.
Metadata Response (direct_download=false)
{
"presigned_url": "https://spaces.example.com/...",
"object_key": "env/files/{project_id}/jpeg-to-png/photo_20260405_123456789.png",
"filename": "photo_20260405_123456789.png",
"file_size": 45678,
"conversion_time_seconds": 0.5
}
Code Examples
Python
import requests
with open("photo.jpg", "rb") as f:
response = requests.post(
"https://api.enconvert.com/v1/convert/jpeg-to-png",
headers={"X-API-Key": "sk_live_your_private_key"},
files={"file": ("photo.jpg", f)}
)
with open("photo_20260405_123456789.png", "wb") as out:
out.write(response.content)
Node.js
const form = new FormData();
form.append("file", fs.createReadStream("photo.jpg"));
const response = await fetch("https://api.enconvert.com/v1/convert/jpeg-to-png", {
method: "POST",
headers: { "X-API-Key": "sk_live_your_private_key" },
body: form
});
fs.writeFileSync("photo_20260405_123456789.png", Buffer.from(await response.arrayBuffer()));
PHP
$ch = curl_init("https://api.enconvert.com/v1/convert/jpeg-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("photo.jpg")]
]);
$output = curl_exec($ch);
curl_close($ch);
file_put_contents("photo_20260405_123456789.png", $output);
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-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 .jpeg or .jpg 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 |