Amazon MediaConvert · JSON Structure

Mediaconvert Api Hdr10 Metadata Structure

Use these settings to specify static color calibration metadata, as defined by SMPTE ST 2086. These values don't affect the pixel values that are encoded in the video stream. They are intended to help the downstream video player display content in a way that reflects the intentions of the the content creator.

Type: object Properties: 12
BroadcastingMedia ProcessingMedia

Hdr10Metadata is a JSON Structure definition published by Amazon MediaConvert, describing 12 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

BluePrimaryX BluePrimaryY GreenPrimaryX GreenPrimaryY MaxContentLightLevel MaxFrameAverageLightLevel MaxLuminance MinLuminance RedPrimaryX RedPrimaryY WhitePointX WhitePointY

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-mediaconvert/refs/heads/main/json-structure/mediaconvert-api-hdr10-metadata-structure.json",
  "name": "Hdr10Metadata",
  "type": "object",
  "description": "Use these settings to specify static color calibration metadata, as defined by SMPTE ST 2086. These values don't affect the pixel values that are encoded in the video stream. They are intended to help the downstream video player display content in a way that reflects the intentions of the the content creator.",
  "properties": {
    "BluePrimaryX": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "bluePrimaryX"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    },
    "BluePrimaryY": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "bluePrimaryY"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    },
    "GreenPrimaryX": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "greenPrimaryX"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    },
    "GreenPrimaryY": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "greenPrimaryY"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    },
    "MaxContentLightLevel": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max65535"
        },
        {
          "xml": {
            "name": "maxContentLightLevel"
          },
          "description": "Maximum light level among all samples in the coded video sequence, in units of candelas per square meter. This setting doesn't have a default value; you must specify a value that is suitable for the content."
        }
      ]
    },
    "MaxFrameAverageLightLevel": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max65535"
        },
        {
          "xml": {
            "name": "maxFrameAverageLightLevel"
          },
          "description": "Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter. This setting doesn't have a default value; you must specify a value that is suitable for the content."
        }
      ]
    },
    "MaxLuminance": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "maxLuminance"
          },
          "description": "Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter."
        }
      ]
    },
    "MinLuminance": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max2147483647"
        },
        {
          "xml": {
            "name": "minLuminance"
          },
          "description": "Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meter"
        }
      ]
    },
    "RedPrimaryX": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "redPrimaryX"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    },
    "RedPrimaryY": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "redPrimaryY"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    },
    "WhitePointX": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "whitePointX"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    },
    "WhitePointY": {
      "allOf": [
        {
          "$ref": "#/components/schemas/__integerMin0Max50000"
        },
        {
          "xml": {
            "name": "whitePointY"
          },
          "description": "HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction."
        }
      ]
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/mediaconvert-api-hdr10-metadata-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.