---
seo_title: JPEG-zu-HEIC-API: JPG per Code in HEIC umwandeln | EnConvert
meta_desc: Konvertieren Sie JPEG zu HEIC mit einer REST-API. POST /v1/convert/jpeg-to-heic liefert hochwertige HEIC-Dateien als rohe Bytes oder presigned URL. Code-Beispiele.
keywords: jpeg in heic umwandeln api, jpg zu heic api, jpeg programmatisch in heic konvertieren, heic kodierung api, jpg heic converter api, heif konvertierung rest api, jpg in heic python
---

# JPEG-zu-HEIC-API

Konvertieren Sie JPEG-Bilder programmatisch mit `POST /v1/convert/jpeg-to-heic` zu HEIC (High Efficiency Image Container). Der Endpunkt akzeptiert einen `.jpeg`- oder `.jpg`-Upload und erzeugt mit dem HEIF-Codec eine hochwertige HEIC-Datei. Die Antwort enthält entweder rohe Bilddaten zum direkten Download oder JSON-Metadaten mit einer presigned Download-URL.

---

## Endpunkt

```
POST /v1/convert/jpeg-to-heic
```

**Content-Type:** `multipart/form-data`

**Akzeptierte Eingabe:** `.jpeg or .jpg`-Dateien

**Ausgabeformat:** `.heic` (`image/heic`)

---

## Authentifizierung

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

```
X-API-Key: sk_your_private_key
```

Oder:

```
Authorization: Bearer <jwt_token>
```

---

## Request-Parameter

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|-----------|------|----------|---------|-------------|
| `file` | Datei | Ja | -- | Die zu konvertierende `.jpeg or .jpg`-Bilddatei. |
| `output_filename` | `string` | Nein | Eingabedateiname | Benutzerdefinierter Ausgabedateiname. Die Endung `.heic` wird automatisch angehängt. |
| `direct_download` | `boolean` | Nein | `true` | Bei `true` werden rohe Bilddaten zurückgegeben. Bei `false` werden JSON-Metadaten mit einer presigned Download-URL zurückgegeben. |

---

## Details zur Konvertierung

- Verwendet **Pillow** mit **pillow-heif** zur HEIC-Kodierung
- Die RGB-Farbdaten des JPEG bleiben in der HEIC-Ausgabe erhalten
- Die Ausgabequalität ist auf Maximum (100) eingestellt
- HEIC erreicht bei gleicher Qualität in der Regel kleinere Dateigrößen als JPEG


---

## Antwort

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

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

Liefert rohe Bilddaten.

### Metadaten-Antwort (`direct_download=false`)

```json
{
    "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
}
```

---

## Code-Beispiele

### Python

```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

```javascript
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

```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

```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)
```

---

## Fehlerantworten

| Status | Bedingung |
|--------|-----------|
| `400 Bad Request` | Datei ist keine `.jpeg or .jpg`-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 ein JPG mit einer REST-API zu HEIC?

Senden Sie einen `multipart/form-data`-POST-Request an `/v1/convert/jpeg-to-heic` mit Ihrer `.jpeg`- oder `.jpg`-Datei im Feld `file`, authentifiziert über `X-API-Key` oder ein `Bearer`-JWT-Token. Standardmäßig antwortet die API mit den rohen HEIC-Bytes.

### Verringert die Konvertierung von JPEG zu HEIC die Dateigröße?

In der Regel ja: HEIC erreicht bei gleicher Qualität meist kleinere Dateigrößen als JPEG. Dieser Endpunkt kodiert mit maximaler Qualität (100) über Pillow mit pillow-heif.

### Kann ich eine Download-URL statt roher Bilddaten erhalten?

Ja. Setzen Sie `direct_download=false`, dann liefert die API JSON-Metadaten mit `presigned_url`, `object_key`, `filename`, `file_size` und `conversion_time_seconds`.

### Warum liefert die API 402 Payment Required?

Ein `402` bedeutet, dass das monatliche Ops-Kontingent oder Speicherlimit Ihres Plans erreicht wurde. Dateien, die die maximale Dateigröße Ihres Plans überschreiten, liefern stattdessen `413 Payload Too Large`.