In der Sandbox ausführen

WebP-zu-JPEG-API#

Die WebP-zu-JPEG-API konvertiert ein WebP-Bild mit einer einzigen Anfrage an POST /v1/convert/webp-to-jpeg in das JPEG-Format. Lade eine .webp-Datei als multipart/form-data hoch und erhalte rohe JPEG-Bytes zurück, oder setze direct_download=false, um stattdessen JSON-Metadaten mit einer presigned Download-URL zu erhalten. Da JPEG keine Transparenz unterstützt, werden transparente Bereiche im WebP auf einem weißen Hintergrund zusammengesetzt.

Endpunkt#

POST /v1/convert/webp-to-jpeg

Content-Type: multipart/form-data

Akzeptierte Eingabe: .webp-Dateien

Ausgabeformat: .jpeg (image/jpeg)

Authentifizierung#

Erfordert entweder einen privaten API-Schlüssel oder ein JWT-Token von einem öffentlichen Schlüssel.

X-API-Key: sk_your_private_key

Oder:

Authorization: Bearer <jwt_token>

Anfrageparameter#

Parameter	Typ	Erforderlich	Standard	Beschreibung
`file`	file	Ja	--	Die zu konvertierende `.webp`-Bilddatei.
`output_filename`	`string`	Nein	Name der Eingabedatei	Benutzerdefinierter Ausgabedateiname. Die Erweiterung `.jpeg` wird automatisch hinzugefügt.
`direct_download`	`boolean`	Nein	`true`	Bei `true` werden rohe Bild-Bytes zurückgegeben. Bei `false` werden JSON-Metadaten mit einer presigned Download-URL zurückgegeben.

Details zur Konvertierung#

Verwendet Pillow für die direkte Formatkonvertierung
Wenn das WebP einen Alphakanal (RGBA) hat, werden transparente Bereiche auf einem weißen Hintergrund zusammengesetzt
Die Ausgabequalität ist auf das Maximum (100) eingestellt

Hinweis zur Transparenz: JPEG unterstützt keine Transparenz. Transparente Bereiche in deinem WebP erscheinen in der JPEG-Ausgabe weiß.

Antwort#

Direkter Download (`direct_download=true`, Standard)#

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

Gibt rohe Bild-Bytes zurück.

Metadaten-Antwort (`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
}

Codebeispiele#

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)

Fehlerantworten#

Status	Bedingung
`400 Bad Request`	Datei ist keine `.webp`-Datei
`400 Bad Request`	Bildkonvertierung fehlgeschlagen (beschädigte oder nicht unterstützte Datei)
`401 Unauthorized`	Fehlender oder ungültiger API-Schlüssel / JWT-Token
`402 Payment Required`	Monatliches Ops-Kontingent aufgebraucht
`402 Payment Required`	Speicherlimit erreicht
`413 Payload Too Large`	Datei überschreitet die maximale Dateigröße des Plans

Limits#

Limit	Wert
Maximale Dateigröße	Abhängig vom Plan (Founding: 5 MB)
Ausgabequalität	Maximum (nicht konfigurierbar)
Monatliche Konvertierungen	Abhängig vom Plan

Häufig gestellte Fragen#

Wie konvertiere ich WebP mit einer REST API in JPEG?#

Sende eine POST-Anfrage an /v1/convert/webp-to-jpeg mit deiner .webp-Datei in einem multipart/form-data-Body und authentifiziere dich mit einem X-API-Key-Header oder einem JWT-Authorization: Bearer-Token. Die API gibt das konvertierte JPEG standardmäßig als rohe Bild-Bytes zurück.

Was passiert mit der Transparenz bei der Konvertierung von WebP zu JPEG?#

JPEG unterstützt keine Transparenz. Wenn das WebP also einen Alphakanal (RGBA) hat, werden transparente Bereiche in der JPEG-Ausgabe auf einem weißen Hintergrund zusammengesetzt.

Kann ich eine Download-URL statt roher JPEG-Bytes erhalten?#

Ja. Setze direct_download=false, und die API gibt anstelle der rohen Bytes JSON-Metadaten zurück, einschließlich presigned_url, filename, file_size und conversion_time_seconds.

Warum gibt die WebP-zu-JPEG-API 402 Payment Required zurück?#

Eine 402 Payment Required-Antwort bedeutet, dass dein monatliches Ops-Kontingent oder Speicherlimit für deinen Plan erreicht wurde.

Was ist die maximale WebP-Dateigröße, die ich hochladen kann?#

Die maximale Dateigröße ist abhängig vom Plan (5 MB im Founding-Plan). Dateien, die das Limit deines Plans überschreiten, werden mit 413 Payload Too Large abgelehnt.

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

API Documentation