diff --git a/multimedia/av_codec/native_avcodec_base.h b/multimedia/av_codec/native_avcodec_base.h
index c5e35031cfa4005ba8484a54ad2014aec1e8fb86..af658326a43af63d84e1e52b7673d8d593ae4c12 100644
--- a/multimedia/av_codec/native_avcodec_base.h
+++ b/multimedia/av_codec/native_avcodec_base.h
@@ -940,6 +940,20 @@ extern const char *OH_MD_KEY_VIDEO_SAR;
  * @since 12
  */
 extern const char *OH_MD_KEY_START_TIME;
+/**
+ * @brief Key for setting the output color space of video decoder. The value type is int32_t.
+ * The supported value is {@link OH_COLORSPACE_BT709_LIMIT}, see {@link OH_NativeBuffer_ColorSpace}. It is used in
+ * {@link OH_VideoDecoder_Configure}. If the color space conversion capability is supported and this key is configured,
+ * the video decoder will automatically transcode an HDR Vivid video to an SDR video with color space BT709.
+ * If color space conversion capability is not supported, {@link OH_VideoDecoder_Configure} returns
+ * {@link AV_ERR_VIDEO_UNSUPPORTED_COLOR_SPACE_CONVERSION}.
+ * If the input video is not an HDR vivid video, an error {@link AV_ERR_VIDEO_UNSUPPORTED_COLOR_SPACE_CONVERSION} will
+ * be reported by callback function {@link OH_AVCodecOnError}.
+ *
+ * @syscap SystemCapability.Multimedia.Media.CodecBase
+ * @since 12
+ */
+extern const char *OH_MD_KEY_VIDEO_DECODER_OUTPUT_COLOR_SPACE;
 
 /**
  * @brief Media type.
diff --git a/multimedia/av_codec/native_avcodec_videodecoder.h b/multimedia/av_codec/native_avcodec_videodecoder.h
index c52df2c28f136c9543db3e4985336834473d8eb6..6291412ec4bfae18c5ba95bcb8adc372894c1d4b 100644
--- a/multimedia/av_codec/native_avcodec_videodecoder.h
+++ b/multimedia/av_codec/native_avcodec_videodecoder.h
@@ -146,6 +146,8 @@ OH_AVErrCode OH_VideoDecoder_SetSurface(OH_AVCodec *codec, OHNativeWindow *windo
  * {@link AV_ERR_UNKNOWN}, unknown error.
  * {@link AV_ERR_SERVICE_DIED}, avcodec service is died.
  * {@link AV_ERR_INVALID_STATE}, this interface was called in invalid state, must be called before Prepare.
+ * {@link AV_ERR_UNSUPPORT}, unsupported features.
+ * {@link AV_ERR_VIDEO_UNSUPPORTED_COLOR_SPACE_CONVERSION}, video unsupported color space conversion.
  * @since 9
  */
 OH_AVErrCode OH_VideoDecoder_Configure(OH_AVCodec *codec, OH_AVFormat *format);
diff --git a/multimedia/media_foundation/native_averrors.h b/multimedia/media_foundation/native_averrors.h
index cffaba60e2f486611b86ed432608f60f6879c548..0a2a54d6077c0d7a9fa039d135f71c30dff49d18 100644
--- a/multimedia/media_foundation/native_averrors.h
+++ b/multimedia/media_foundation/native_averrors.h
@@ -92,6 +92,16 @@ typedef enum OH_AVErrCode {
      * @since 12
      */
     AV_ERR_DRM_DECRYPT_FAILED = 201,
+    /**
+     * @error video error base.
+     * @since 12
+     */
+    AV_ERR_VIDEO_BASE = 300,
+    /**
+     * @error video unsupported color space conversion.
+     * @since 12
+     */
+    AV_ERR_VIDEO_UNSUPPORTED_COLOR_SPACE_CONVERSION = 301,
 } OH_AVErrCode;
 
 #ifdef __cplusplus