动态与公告

产品动态

产品公告

产品简介

产品概述

产品优势

应用场景

功能概览

地域与域名

使用限制

产品计费

计费概述

计费方式

计费项

免费额度

欠费说明

查看消费明细

常见问题

快速入门

注册与登录

绑定存储桶

上传和处理文件

下载和删除文件

解绑存储桶

通过 COS 使用数据万象

能力地图

图片处理

媒体处理

内容审核

AI 内容识别

文档处理

智能语音

文件处理

用户指南

概览

存储桶管理

智能工具箱

任务与工作流

数据监控

用量统计

实践教程

版权保护解决方案

图片处理实践

API 授权策略使用指引

工作流实践

API 文档

API 概览

结构体

公共请求头部

公共响应头部

开通万象服务

图片处理

AI 内容识别

智能语音

媒体处理

内容审核

文档处理

文件处理

任务与工作流

云查毒

错误码

请求签名

SDK 文档

SDK 概览

图片处理 Android SDK

图片处理 iOS SDK

COS Android SDK

C SDK

C++ SDK

.NET(C#) SDK

Go SDK

COS iOS SDK

Java SDK

JavaScript SDK

Node.js SDK

PHP SDK

Python SDK

小程序 SDK

SDK 产品个人信息保护规则

安全与合规

权限管理

常见问题

基础设置

文档处理

媒体处理

内容识别

智能语音

服务协议

Service Level Agreement

联系我们

词汇表

HDR 图片处理

PDF

聚焦模式

字号

最后更新时间： 2025-12-09 14:19:34

功能描述
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
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

支持在处理时保留的 HDR 类型	支持的处理方式
JPG/JPEG：Ultra HDR（ISO 标准的 GainMap HDR）	下载时处理
HEIF/HEIC：10-bit 原生 HDR、Apple 标准的 GainMap HDR	下载时处理
AVIF：10-bit 原生 HDR	下载时处理

参数	含义	默认值	类型	是否必选
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	否

tencent cloud

数据万象

HDR 图片处理

功能描述

授权说明

服务开通

使用限制

费用说明

接口形式

处理参数说明

实际案例

案例一：缩放宽高

案例二：缩放裁剪

帮助和支持