Ejecutar en el sandbox

API de JPEG a PNG#

Convierte imágenes JPEG a PNG mediante programación con POST /v1/convert/jpeg-to-png. El endpoint acepta una subida .jpeg o .jpg y produce un PNG sin pérdida con fidelidad de color completa. Las respuestas devuelven los bytes de la imagen sin procesar para descarga directa o metadatos JSON con una URL de descarga prefirmada.

Endpoint#

POST /v1/convert/jpeg-to-png

Content-Type: multipart/form-data

Entrada aceptada: archivos .jpeg or .jpg

Formato de salida: .png (image/png)

Autenticación#

Requiere una clave API privada o un token JWT obtenido de una clave pública.

X-API-Key: sk_your_private_key

O bien:

Authorization: Bearer <jwt_token>

Parámetros de la solicitud#

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
`file`	file	Sí	--	El archivo de imagen `.jpeg or .jpg` a convertir.
`output_filename`	`string`	No	Nombre del archivo de entrada	Nombre de archivo de salida personalizado. La extensión `.png` se añade automáticamente.
`direct_download`	`boolean`	No	`true`	Con `true`, devuelve los bytes de la imagen sin procesar. Con `false`, devuelve metadatos JSON con una URL de descarga prefirmada.

Detalles de la conversión#

Usa Pillow para la conversión directa de formato
Los datos de color RGB del JPEG se conservan sin pérdida en el PNG de salida
La salida PNG usa compresión sin pérdida
La calidad de salida es máxima (sin pérdida)

Respuesta#

Descarga directa (`direct_download=true`, predeterminado)#

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

Devuelve los bytes de la imagen sin procesar.

Respuesta con metadatos (`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
}

Ejemplos de código#

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

Respuestas de error#

Estado	Condición
`400 Bad Request`	El archivo no es un archivo `.jpeg or .jpg`
`400 Bad Request`	La conversión de la imagen falló (archivo dañado o no compatible)
`401 Unauthorized`	Clave API o token JWT ausente o no válido
`402 Payment Required`	Cuota mensual de ops agotada
`402 Payment Required`	Límite de almacenamiento alcanzado
`413 Payload Too Large`	El archivo supera el tamaño máximo del plan

Límites#

Límite	Valor
Tamaño máximo de archivo	Según el plan (Founding: 5 MB)
Calidad de salida	Máxima (no configurable)
Conversiones mensuales	Según el plan

Preguntas frecuentes#

¿Cómo convierto un JPG a PNG con una API REST?#

Envía una solicitud POST multipart/form-data a /v1/convert/jpeg-to-png con tu archivo .jpeg o .jpg en el campo file, autenticada vía X-API-Key o un token JWT Bearer. De forma predeterminada, la API responde con los bytes del PNG sin procesar.

¿La conversión de JPEG a PNG es sin pérdida?#

Sí. Los datos de color RGB del JPEG se conservan sin pérdida en el PNG de salida, y el propio PNG usa compresión sin pérdida a calidad máxima.

¿Puedo obtener una URL de descarga en lugar de los bytes de la imagen?#

Sí. Establece direct_download=false y la API devuelve metadatos JSON que incluyen presigned_url, object_key, filename, file_size y conversion_time_seconds.

¿Por qué la API devuelve 402 Payment Required?#

Un 402 significa que se agotó la cuota mensual de ops o se alcanzó el límite de almacenamiento de tu plan. Los archivos que superan el tamaño máximo de archivo de tu plan devuelven 413 Payload Too Large en su lugar.

← Images png-to-jpeg →

API Documentation