---
updatedAt: 2026-04-27T18:04:40.000Z
agentTools:
  projectIndex: https://api.encoding.com/llms.txt
---

# HLG

> 🚧 Note
>
> HLG available only for [hevc](https://api.encoding.com/reference/output-hevc) and [apple\_prores](https://api.encoding.com/reference/output-apple-prores) **\<video\_codec />**.

> 🚧 Note
>
> HLG available only for **apple\_prores**, **mp4**, **mpegts**, **fmp4\_hls**, **advanced\_dash**, and **advanced\_fmp4** output formats.

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[mp4|mpegts|apple_prores]</output> <!-- required-->
        <hdr>[hlg|hlg-sdr-compat|hlg-non-sdr-compat]</hdr>
        <video_codec_parameters>
            <level>[Level]</level>
        </video_codec_parameters>
        <tonemap>
            <!-- Tone mapping params --> 
        </tonemap>
        <!-- Format params -->
    </format>
</query>
```
```json
{
    "query": {
        "userid": "[UserID]", // required
        "userkey": "[UserKey]", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[mp4|mpegts|apple_prores]", // required
            "hdr": "[hlg|hlg-sdr-compat|hlg-non-sdr-compat]",
            "video_codec_parameters": {
                "level": "[Level]"
            },
            "tonemap": {
                // Tone mapping params
            }
            // Format params
        }
    }
}
```
```XML Multi-Bitrate
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[fmp4_hls|advanced_dash|advanced_fmp4]</output> <!-- required-->
        <destination>[DestinationURL]</destination> <!-- required-->
        <stream>
            <hdr>[hlg|hlg-sdr-compat|hlg-non-sdr-compat]</hdr>
            <video_codec_parameters>
                <level>[Level]</level>
            </video_codec_parameters>
            <tonemap>
                <!-- Tone mapping params -->
            </tonemap>
        </stream>
        <stream>
            <!-- stream params -->
        </stream>
        <!-- Format params -->
    </format>
</query>
```
```JSON Multi-Bitrate
{
    "query": {
        "userid": "[UserID]", // required
        "userkey": "[UserKey]", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[fmp4_hls|advanced_dash|advanced_fmp4]", // required
            "destination": "[DestinationURL]", // required
            "stream": [
                {
                    "hdr": "[hlg|hlg-sdr-compat|hlg-non-sdr-compat]",
                    "video_codec_parameters": {
                        "level": "[Level]"
                    },
                    "tonemap": {
                        // Tone mapping params
                    }
                },
                {
                    // stream params
                }
            ],
            "segment_template": "[number|time]"
            // Format params
        }
    }
}
```

| Parameter                  | Description                                                                | Available Values                                                                                                                                                                                                                                                                                                                                                                                         | Default Value |
| :------------------------- | :------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ |
| **Format Parameters**      |                                                                            | -                                                                                                                                                                                                                                                                                                                                                                                                        |               |
| **hdr**                    | HDR mode                                                                   | **hlg** – default HLG mode. Transfer characteristics - 14 (BT.2020); alternative transfer characteristics - 18 (HLG).<br/>**hlg-sdr-compat** – SDR compatible mode. Transfer characteristics - 1 (BT.709); alternative transfer characteristics - 18 (HLG).<br/>**hlg-non-sdr-compat**  – Non-SDR compatible mode. Transfer characteristics - 18 (HLG); alternative transfer characteristics - 18 (HLG). | *none*        |
| **tonemap**                | Configures SDR-to-HDR tone mapping settings. [Details](https://api.encoding.com/reference/tonemap-params) |                                                                                                                                                                                                                                                                                                                                                                                                          | *none*        |
| **Video Codec Parameters** | -                                                                          | -                                                                                                                                                                                                                                                                                                                                                                                                        | -             |
| **level**                  | Video Level                                                                | Valid video level string                                                                                                                                                                                                                                                                                                                                                                                 | 5.0           |