Ejecutar en el sandbox

API de JPEG a HEIC#

Convierte imágenes JPEG a HEIC (High Efficiency Image Container) mediante programación con POST /v1/convert/jpeg-to-heic. El endpoint acepta una carga .jpeg o .jpg y produce un archivo HEIC de alta calidad usando el códec HEIF. Las respuestas devuelven bytes de imagen sin procesar para descarga directa o metadatos JSON con una URL de descarga firmada.

Endpoint#

POST /v1/convert/jpeg-to-heic

Content-Type: multipart/form-data

Entrada aceptada: archivos .jpeg or .jpg

Formato de salida: .heic (image/heic)

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 `.jpeg or .jpg` a convertir.
`output_filename`	`string`	No	Nombre del archivo de entrada	Nombre de archivo de salida personalizado. La extensión `.heic` 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 con pillow-heif para la codificación HEIC
Los datos de color RGB del JPEG se preservan en la salida HEIC
La calidad de salida está fijada al máximo (100)
HEIC normalmente logra tamaños de archivo menores que JPEG con calidad equivalente

Respuesta#

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

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

Devuelve bytes de imagen sin procesar.

Respuesta de metadatos (`direct_download=false`)#

{
    "presigned_url": "https://spaces.example.com/...",
    "object_key": "env/files/{project_id}/jpeg-to-heic/photo_20260405_123456789.heic",
    "filename": "photo_20260405_123456789.heic",
    "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-heic",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("photo.jpg", f)}
    )

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

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

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/jpeg-to-heic");
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.heic", $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-heic", 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 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 un JPG a HEIC con una API REST?#

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

¿Convertir JPEG a HEIC reduce el tamaño del archivo?#

Normalmente sí: HEIC suele lograr tamaños de archivo menores que JPEG con calidad equivalente. Este endpoint codifica a máxima calidad (100) usando Pillow con pillow-heif.

¿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.

¿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 en su lugar 413 Payload Too Large.

← svg-to-jpeg heic-to-jpeg →

API Documentation