HDR 图片处理

最近更新时间:2025-11-17 10:51:42

我的收藏

功能描述

HDR(High Dynamic Range Imaging),高动态范围成像,是一种能够显示更大曝光动态范围的图像,它能保留图像中的更多细节和色彩信息,使图像的明暗差别更明显、色彩更丰富,从而提供更真实和丰富的视觉体验。
数据万象支持在进行图片基础处理(如缩放、裁剪等)时保留图片原有的 HDR 信息,使处理后的图片依然能展示出 HDR 效果。

授权说明

通过子账号使用时,需要在 授权策略 的 action 中添加 cos:GetObject。对象存储支持的所有操作接口请参见 COS action
说明:
GetObject 对应的 resource 为源文件。

服务开通

首次使用该功能时将默认为您开通数据万象,同时该存储桶将自动绑定数据万象,无需角色授权,即可直接使用。
注意:
数据万象绑定后,如果您手动对存储桶进行数据万象的解绑操作,将无法继续使用该功能。

使用限制

该接口需要与 基础图片处理 搭配使用,请先确认基础图片处理相关限制条件。详情请参见 使用限制
不支持处理 COS 上的归档存储类型和深度归档存储类型的图片,如果需要处理此类型文件,请先 恢复归档文件
当前仅支持处理部分 HDR 类别与图片格式,见下表格:
支持在处理时保留的 HDR 类型
支持的处理方式
JPG/JPEG:Ultra HDR(ISO 标准的 GainMap HDR)
下载时处理
HEIF/HEIC:10-bit 原生 HDR、Apple 标准的 GainMap HDR
下载时处理
AVIF:10-bit 原生 HDR
下载时处理

费用说明

HDR 图片为付费服务,与基础图片处理搭配使用时,将产生 HDR 图片处理费用,如果处理结果图为HEIF/HEIC或AVIF格式,将产生图片高级压缩和 HDR 图片处理两项费用,详细计费说明可参见 图片处理费用
通过下载时处理的方式,且通过外网进行下载,调用会产生 数据万象流量费用
如果图片为 COS 上的低频存储类型,调用接口会产生 COS 低频数据取回费用

接口形式

GET /<ObjectKey>?imageMogr2/hdr/<mode> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:
Authorization:携带鉴权信息,用于验证请求的合法性,详情请参见 请求签名 文档。

处理参数说明

数据万象通过 imageMogr2 提供一系列的图片处理操作,HDR 图片处理的参数为hdr,需要搭配其他 imageMogr2处理参数一起使用。
参数
含义
默认值
类型
是否必选
ObjectKey
对象文件名,例如 folder/sample.jpg。
String
/hdr/<mode>
在原图为 HDR 图片(10-bit 色深或带有 GainMap)时该参数才有意义,需要搭配 imageMogr2的其他处理参数一起使用,<mode>值可取0、1:
0:处理后不保留 HDR 信息,图片在处理后将降级为 SDR 图片。
1:处理后按原图的 HDR 类型保留 HDR 信息,当前支持 JPG、HEIF、AVIF 三种格式的 HDR 图片,具体可见上方表格。
0
Int
说明:
要处理 HEIF/HEIC 或 AVIF 格式的图片,需开启 图片高级压缩功能

实际案例

案例一:缩放宽高

对原图为 HDR 的图片进行缩放宽高操作,缩放为原图50%并输出为 HDR 图片,示例如下:
http://example-12500000.cos.ap-shanghai.myqcloud.com/sample.avif?imageMogr2/thumbnail/!50p/hdr/1

案例二:缩放裁剪

对原图为 HDR 的图片进行缩放裁剪操作,以中心点 center 为参考点,缩放裁剪至300×400并输出为 HDR 图片,示例如下:
http://example-12500000.cos.ap-shanghai.myqcloud.com/sample.avif?imageMogr2/crop/300x400/gravity/center/hdr/1