Exécuter dans le bac à sable

API PNG en JPEG#

Convertissez des images PNG en JPEG par programmation avec POST /v1/convert/png-to-jpeg. L'endpoint accepte un fichier .png et, comme JPEG ne prend pas en charge la transparence, aplatit les zones transparentes sur un fond blanc. La réponse contient soit les octets bruts de l'image pour un téléchargement direct, soit des métadonnées JSON avec une URL de téléchargement présignée.

Endpoint#

POST /v1/convert/png-to-jpeg

Content-Type : multipart/form-data

Entrée acceptée : fichiers .png

Format de sortie : .jpeg (image/jpeg)

Authentification#

Requiert une clé API privée ou 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	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 `.jpeg` est ajoutée automatiquement.
`direct_download`	`boolean`	Non	`true`	Avec `true`, renvoie les octets bruts de l'image. Avec `false`, renvoie des métadonnées JSON avec une URL de téléchargement présignée.

Détails de la conversion#

Utilise Pillow pour la conversion directe de format
Si le PNG possède un canal alpha (RGBA), les zones transparentes sont aplaties sur un fond blanc avant la conversion
Les autres modes de couleur non RGB sont convertis en RGB
La qualité de sortie est réglée au maximum (100)

Note sur la transparence : JPEG ne prend pas en charge la transparence. Toute zone transparente ou semi-transparente de votre PNG apparaîtra en blanc dans le JPEG de sortie.

Réponse#

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

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

Renvoie les octets bruts de l'image.

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

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

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

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

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/png-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("image.png")]
]);
$output = curl_exec($ch);
curl_close($ch);
file_put_contents("image_20260405_123456789.jpeg", $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-jpeg", 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`	Échec de la conversion de l'image (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 plan

Limites#

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

Questions fréquentes#

Comment convertir un PNG en JPG avec une API REST ?#

Envoyez une requête POST multipart/form-data à /v1/convert/png-to-jpeg avec votre fichier .png dans le champ file, authentifiée via X-API-Key ou un jeton JWT Bearer. Par défaut, l'API répond avec les octets JPEG bruts.

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

JPEG ne prend pas en charge la transparence : toute zone transparente ou semi-transparente du PNG (canal alpha RGBA) est aplatie sur un fond blanc et apparaîtra en blanc dans le JPEG de sortie.

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

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

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

Non. La qualité de sortie est fixée au maximum (100) et n'est pas configurable. Vous pouvez personnaliser le nom du fichier de sortie avec le paramètre output_filename ; l'extension .jpeg est ajoutée automatiquement.

← jpeg-to-png jpeg-to-svg →

API Documentation