Ejecutar en el sandbox

API de HEIC a JPG#

Convierte imágenes HEIC/HEIF a JPEG mediante programación con POST /v1/convert/heic-to-jpeg. El endpoint acepta una carga .heic o .heif, la decodifica y produce un JPEG de alta calidad. Las respuestas devuelven bytes de imagen sin procesar para descarga directa o metadatos JSON con una URL de descarga firmada.

Endpoint#

POST /v1/convert/heic-to-jpeg

Content-Type: multipart/form-data

Entrada aceptada: archivos .heic or .heif

Formato de salida: .jpeg (image/jpeg)

Autenticación#

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

X-API-Key: sk_your_private_key

Authorization: Bearer <jwt_token>

Parámetros de solicitud#

Parámetro	Tipo	Obligatorio	Valor predeterminado	Descripción
`file`	archivo	Sí	--	El archivo de imagen `.heic or .heif` a convertir.
`output_filename`	`string`	No	Nombre del archivo de entrada	Nombre de archivo de salida personalizado. La extensión `.jpeg` se añade automáticamente.
`direct_download`	`boolean`	No	`true`	Cuando es `true`, devuelve bytes de imagen sin procesar. Cuando es `false`, devuelve metadatos JSON con una URL de descarga firmada.

Detalles de la conversión#

Usa pillow-heif para la decodificación HEIC y Pillow para la codificación JPEG
Si la imagen HEIC tiene un canal alfa, las áreas transparentes se componen sobre un fondo blanco
La calidad de salida está fijada al máximo (100)

Respuesta#

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

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

Devuelve bytes de imagen sin procesar.

Respuesta de metadatos (`direct_download=false`)#

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

Ejemplos de código#

Python#

import requests

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

with open("photo_20260405_123456789.jpeg", "wb") as out:
    out.write(response.content)

Node.js#

const form = new FormData();
form.append("file", fs.createReadStream("photo.heic"));

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

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

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/heic-to-jpeg");
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.heic")]
]);
$output = curl_exec($ch);
curl_close($ch);
file_put_contents("photo_20260405_123456789.jpeg", $output);

Go#

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", "photo.heic")
file, _ := os.Open("photo.heic")
io.Copy(part, file)
writer.Close()

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/heic-to-jpeg", 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 `.heic or .heif`
`400 Bad Request`	La conversión de imagen falló (archivo corrupto o no compatible)
`401 Unauthorized`	Clave de API o token JWT faltante o inválido
`402 Payment Required`	Se agotó la cuota mensual de ops
`402 Payment Required`	Se alcanzó el límite de almacenamiento
`413 Payload Too Large`	El archivo supera el tamaño máximo de archivo 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 HEIC a JPG con una API REST?#

Envía una solicitud POST multipart/form-data a /v1/convert/heic-to-jpeg con tu archivo .heic o .heif en el campo file, autenticada mediante X-API-Key o un token JWT Bearer. Por defecto, la API responde con los bytes JPEG sin procesar.

¿La API acepta tanto archivos .heic como .heif?#

Sí. El parámetro file acepta archivos .heic o .heif; cualquier otro tipo devuelve 400 Bad Request. La decodificación usa pillow-heif y la codificación JPEG usa Pillow.

¿Qué ocurre si la imagen HEIC tiene transparencia?#

JPEG no admite transparencia, por lo que si la imagen HEIC tiene un canal alfa, las áreas transparentes se componen sobre un fondo blanco en la salida.

¿Puedo obtener una URL de descarga en lugar de bytes de imagen sin procesar?#

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

← jpeg-to-heic jpeg-to-webp →

API Documentation