Exécuter dans le bac à sable

API PNG vers HEIC#

L'API PNG vers HEIC convertit une image PNG au format HEIC (High Efficiency Image Container) en une seule requête vers POST /v1/convert/png-to-heic. Envoyez un fichier .png en multipart/form-data et recevez les octets HEIC bruts en retour, ou définissez direct_download=false pour obtenir des métadonnées JSON avec une URL de téléchargement présignée. Comme HEIC ne prend pas en charge la transparence, les zones transparentes du PNG sont composées sur un fond blanc.

Point de terminaison#

POST /v1/convert/png-to-heic

Content-Type : multipart/form-data

Entrée acceptée : fichiers .png

Format de sortie : .heic (image/heic)

Authentification#

Nécessite soit une clé API privée, soit un jeton JWT issu d'une clé publique.

X-API-Key: sk_your_private_key

Ou :

Authorization: Bearer <jwt_token>

Paramètres de la requête#

Paramètre	Type	Requis	Par défaut	Description
`file`	file	Oui	--	Le fichier image `.png` à convertir.
`output_filename`	`string`	Non	Nom du fichier d'entrée	Nom de fichier de sortie personnalisé. L'extension `.heic` est ajoutée automatiquement.
`direct_download`	`boolean`	Non	`true`	Lorsque la valeur est `true`, renvoie les octets bruts de l'image. Lorsqu'elle est `false`, renvoie des métadonnées JSON avec une URL de téléchargement présignée.

Détails de la conversion#

Utilise Pillow avec pillow-heif pour l'encodage HEIC
Si le PNG possède un canal alpha (RGBA), les zones transparentes sont composées sur un fond blanc
La qualité de sortie est réglée au maximum (100)

Note sur la transparence : HEIC ne prend pas en charge la transparence. Toute zone transparente de votre PNG apparaîtra en blanc dans la sortie HEIC.

Réponse#

Téléchargement direct (`direct_download=true`, par défaut)#

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

Renvoie les octets bruts de l'image.

Réponse de métadonnées (`direct_download=false`)#

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

Exemples de code#

Python#

import requests

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

with open("image_20260405_123456789.heic", "wb") as out:
    out.write(response.content)

Node.js#

const form = new FormData();
form.append("file", fs.createReadStream("image.png"));

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

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

PHP#

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

Go#

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

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/png-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)

Réponses d'erreur#

Statut	Condition
`400 Bad Request`	Le fichier n'est pas un fichier `.png`
`400 Bad Request`	La conversion de l'image a échoué (fichier corrompu ou non pris en charge)
`401 Unauthorized`	Clé API / jeton JWT manquant ou invalide
`402 Payment Required`	Quota mensuel d'ops épuisé
`402 Payment Required`	Limite de stockage atteinte
`413 Payload Too Large`	Le fichier dépasse la taille maximale autorisée par le forfait

Limites#

Limite	Valeur
Taille maximale de fichier	Selon le forfait (Founding : 5 MB)
Qualité de sortie	Maximale (non configurable)
Conversions mensuelles	Selon le forfait

Questions fréquentes#

Comment convertir PNG en HEIC avec une API REST ?#

Envoyez une requête POST à /v1/convert/png-to-heic avec votre fichier .png dans un corps multipart/form-data, authentifiée via X-API-Key ou un jeton JWT Authorization: Bearer. Le HEIC converti est renvoyé par défaut sous forme d'octets bruts.

Que devient la transparence du PNG lors de la conversion en HEIC ?#

HEIC ne prend pas en charge la transparence : si le PNG possède un canal alpha (RGBA), les zones transparentes sont composées sur un fond blanc dans le HEIC produit.

Puis-je contrôler la qualité de sortie du HEIC ?#

Non. La qualité de sortie est réglée au maximum (100) et n'est pas configurable. L'encodage utilise Pillow avec pillow-heif.

Puis-je obtenir une URL de téléchargement au lieu des octets HEIC bruts ?#

Oui. Définissez direct_download=false et l'API renvoie des métadonnées JSON avec presigned_url, filename, file_size et conversion_time_seconds.

Pourquoi l'API renvoie-t-elle 413 Payload Too Large ?#

Le fichier envoyé dépasse la taille maximale autorisée par votre forfait (5 MB pour le forfait Founding).

← svg-to-png heic-to-png →

API Documentation