Esegui nella sandbox

API da WebP a JPEG#

L'API da WebP a JPEG converte un'immagine WebP in formato JPEG con una singola richiesta a POST /v1/convert/webp-to-jpeg. Carica un file .webp come multipart/form-data e ricevi i byte JPEG grezzi in risposta, oppure imposta direct_download=false per ottenere metadati JSON con un URL di download presigned. Poiché JPEG non supporta la trasparenza, le aree trasparenti del WebP vengono composite su uno sfondo bianco.

Endpoint#

POST /v1/convert/webp-to-jpeg

Content-Type: multipart/form-data

Input accettato: file .webp

Formato di output: .jpeg (image/jpeg)

Autenticazione#

Richiede una chiave API privata oppure un token JWT generato da una chiave pubblica.

X-API-Key: sk_your_private_key

Oppure:

Authorization: Bearer <jwt_token>

Parametri della richiesta#

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
`file`	file	Sì	--	Il file immagine `.webp` da convertire.
`output_filename`	`string`	No	Nome del file di input	Nome file di output personalizzato. L'estensione `.jpeg` viene aggiunta automaticamente.
`direct_download`	`boolean`	No	`true`	Se `true`, restituisce i byte grezzi dell'immagine. Se `false`, restituisce metadati JSON con un URL di download presigned.

Dettagli della conversione#

Usa Pillow per la conversione diretta del formato
Se il WebP ha un canale alfa (RGBA), le aree trasparenti vengono composite su uno sfondo bianco
La qualità di output è impostata al massimo (100)

Nota sulla trasparenza: JPEG non supporta la trasparenza. Le eventuali aree trasparenti del tuo WebP appariranno bianche nell'output JPEG.

Risposta#

Download diretto (`direct_download=true`, predefinito)#

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

Restituisce i byte grezzi dell'immagine.

Risposta con metadati (`direct_download=false`)#

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

Esempi di codice#

Python#

import requests

with open("image.webp", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/webp-to-jpeg",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("image.webp", 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.webp"));

const response = await fetch("https://api.enconvert.com/v1/convert/webp-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/webp-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.webp")]
]);
$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.webp")
file, _ := os.Open("image.webp")
io.Copy(part, file)
writer.Close()

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

Risposte di errore#

Stato	Condizione
`400 Bad Request`	Il file non è un file `.webp`
`400 Bad Request`	Conversione dell'immagine non riuscita (file corrotto o non supportato)
`401 Unauthorized`	Chiave API / token JWT mancante o non valido
`402 Payment Required`	Quota mensile di ops esaurita
`402 Payment Required`	Limite di storage raggiunto
`413 Payload Too Large`	Il file supera la dimensione massima prevista dal piano

Limiti#

Limite	Valore
Dimensione massima del file	Dipende dal piano (Founding: 5 MB)
Qualità di output	Massima (non configurabile)
Conversioni mensili	Dipende dal piano

Domande frequenti#

Come converto WebP in JPEG con una API REST?#

Invia una richiesta POST a /v1/convert/webp-to-jpeg con il tuo file .webp in un body multipart/form-data e autenticati con un header X-API-Key o un token JWT Authorization: Bearer. Per impostazione predefinita l'API restituisce il JPEG convertito come byte grezzi dell'immagine.

Cosa succede alla trasparenza quando converto WebP in JPEG?#

JPEG non supporta la trasparenza, quindi se il WebP ha un canale alfa (RGBA), le aree trasparenti vengono composite su uno sfondo bianco nell'output JPEG.

Posso ottenere un URL di download invece dei byte JPEG grezzi?#

Sì. Imposta direct_download=false e l'API restituisce metadati JSON che includono presigned_url, filename, file_size e conversion_time_seconds invece dei byte grezzi.

Perché l'API da WebP a JPEG restituisce 402 Payment Required?#

Una risposta 402 Payment Required significa che è stata esaurita la quota mensile di ops o raggiunto il limite di storage del tuo piano.

Qual è la dimensione massima del file WebP che posso caricare?#

La dimensione massima del file dipende dal piano (5 MB nel piano Founding). I file che superano il limite del tuo piano vengono rifiutati con 413 Payload Too Large.

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

API Documentation