[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["わかりにくい","hardToUnderstand","thumb-down"],["情報またはサンプルコードが不正確","incorrectInformationOrSampleCode","thumb-down"],["必要な情報 / サンプルがない","missingTheInformationSamplesINeed","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-09-04 UTC。"],[],[],null,["# Convert an input video to HDR\n\nThis page explains how to convert the input video in a transcoding job to a\nsupported high dynamic range (HDR) or standard dynamic range (SDR) format. The\nTranscoder API uses high-efficiency video coding (HEVC) as the primary\ncodec for the color conversion. Passthrough is enabled by default if you don't\nspecify a color conversion format.\n\nColor conversion formats\n------------------------\n\nHEVC is the primary codec used for the supported color conversion formats, which\ninclude the following:\n\n- Hybrid log-gamma (HLG)\n- SDR\n- HDR10\n\nFor [H.264](/transcoder/docs/reference/rest/v1/JobConfig#VideoStream.FIELDS.h264) and [VP9](/transcoder/docs/reference/rest/v1/JobConfig#VideoStream.FIELDS.vp9) streams, only HLG and SDR are supported. All\nconversions between the supported codec and the preceding color formats are\nsupported.\n\nPassthrough\n-----------\n\nPassthrough is enabled by default if you don't specify a color conversion\nformat.\n\nFor passthrough, the Transcoder API honors the input color primaries,\ntransfer function, range, chroma location, and color space; no color conversion\nis done in the process. If the input is HDR10 (or HDR10+) and HEVC, the\nTranscoder API also passes the metadata through to the output video.\n\nIf you specify an output codec that does not support the input's color format,\nthe passthrough is best effort. For example, an input HDR10 video has 10-bit\noptions for [`profile`](/transcoder/docs/reference/rest/v1/JobConfig#H265CodecSettings.FIELDS.profile) and [`pixelFormat`](/transcoder/docs/reference/rest/v1/JobConfig#H265CodecSettings.FIELDS.pixel_format). If you\nspecify the output as H.265 with an 8-bit option for [`profile`](/transcoder/docs/reference/rest/v1/JobConfig#H265CodecSettings.FIELDS.profile),\nthe output is not a valid HDR10 video because HDR10 does not work with an 8-bit\noption for [`profile`](/transcoder/docs/reference/rest/v1/JobConfig#H265CodecSettings.FIELDS.profile).\n\nExample conversions\n-------------------\n\nTo specify the color conversion format, use an empty [`hlg`](/transcoder/docs/reference/rest/v1/JobConfig#H264CodecSettings.FIELDS.hlg),\n[`hdr10`](/transcoder/docs/reference/rest/v1/JobConfig#H265CodecSettings.FIELDS.hdr10), or [`sdr`](/transcoder/docs/reference/rest/v1/JobConfig#H264CodecSettings.FIELDS.sdr) object. The following sections show the\nJSON object to add to a [`VideoStream`](/transcoder/docs/reference/rest/v1/JobConfig#VideoStream) to perform a given\nconversion.\n\n### Convert to HLG format\n\nUse the [`hlg`](/transcoder/docs/reference/rest/v1/JobConfig#H264CodecSettings.FIELDS.hlg) object to convert an input video to HLG format. \n\n \"elementaryStreams\": [\n {\n \"key\": \"video_hlg\",\n \"videoStream\": {\n \"h264\": {\n \"heightPixels\": 720,\n \"widthPixels\": 1280,\n \"bitrateBps\": 5000000,\n \"frameRate\": 25,\n \"hlg\":{}\n }\n }\n ]\n\n### Convert to HDR10 format\n\nUse the [`hdr10`](/transcoder/docs/reference/rest/v1/JobConfig#H265CodecSettings.FIELDS.hdr10) object to convert an input video to HDR10 format. \n\n \"elementaryStreams\": [\n {\n \"key\": \"video_hdr10\",\n \"videoStream\": {\n \"h265\": {\n \"heightPixels\": 720,\n \"widthPixels\": 1280,\n \"bitrateBps\": 5000000,\n \"frameRate\": 25,\n \"pixelFormat\":\"yuv420p10\",\n \"profile\":\"main10\",\n \"hdr10\":{}\n }\n }\n ]\n\n### Down-convert to SDR format\n\nUse the [`sdr`](/transcoder/docs/reference/rest/v1/JobConfig#H264CodecSettings.FIELDS.sdr) object to down-convert an input video to SDR format. \n\n \"elementaryStreams\": [\n {\n \"key\": \"video_sdr\",\n \"videoStream\": {\n \"h264\": {\n \"heightPixels\": 720,\n \"widthPixels\": 1280,\n \"bitrateBps\": 5000000,\n \"frameRate\": 25,\n \"sdr\":{}\n }\n }\n ]\n\nPossible errors\n---------------\n\nIf the Transcoder API cannot perform the conversion, the transcoding job\nfails. Possible errors include the following:\n\n- Conversion to HDR10 format with 8-bit pixel formats or profiles\n- SDR inputs that don't conform to [BT.709](https://www.itu.int/rec/R-REC-BT.709)"]]