元信息保留与去除
简介
imageMogr2 提供一系列高级图片处理功能,本文介绍 图片元信息保留与去除 的使用,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价。
- 图片元信息包括:bKGD、cHRM、EXIF、gAMA、iCCP、iTXt、sRGB、tEXt、zCCP、zTXt、date等
限制说明
- 原图格式支持:
psd
、jpeg
、png
、gif
、webp
、tiff
、bmp
、avif
、heic
- 同步处理
- 原图支持 20MB 以内的图片
- 处理前动图帧数限制:
webp动图
最大帧数为50,gif
最大帧数为 200 - 处理前体积限制:图片
w
和h
不能超过3万像素,总像素不能超过1.5亿像素 - 处理后体积限制:图片
w
和h
不能超过9999像素,总像素不得超过2500w 像素。以下情况特别说明:- 输出为
avif
时,图片w
和h
不能超过9999像素,总像素不能超过768w像素 - 输出为
webp静图
时,图片w
和h
不能超过16383像素,总像素不得超过2500w 像素 - 仅限
输入为webp动图格式,输出webp动图/gif动图时
,图片w
和h
不能超过999像素,总像素(宽x高x帧数)不能超过3150万像素
- 输出为
- 持久化处理
- 原图支持 512MB 以内的图片
- 处理前动图帧数限制:
gif
、webp动图
,最大帧数为 500 - 处理前体积限制:图片
w
和h
不能超过3万像素,总像素不能超过1.5亿像素 - 处理后体积限制:图片
w
和h
不能超过14999像素,总像素不得超过6000w像素。以下情况特别说明:- 输出为
heic
和avif
时,图片w
和h
不能超过9999像素,总像素不能超过3072w像素 - 输出为
webp动图和静图
时,图片w
和h
不能超过16383像素,总像素不得超过6000w像素
- 输出为
参数说明
注意:接口规格不含任何空格与换行符。
imageMogr2/strip
/meta-keep-list/<metaKeepList>
/exifModify/<exifModify>
参数说明
参数名称 | 必填 | 说明 |
---|---|---|
/strip |
否 | 去除图片的全部元信息 ● strip 参数单独使用保留指定的图片元信息,其他信息删除 ● strip 和 meta-keep-list 参数一起使用,即 strip/meta-keep-list |
/meta-keep-list/<metaKeepList> |
否 | 保留指定的图片元信息,其他信息尽量保留 (参数单独使用时) ● 一级标签取值范围: icc (色彩信息)、exif (exif 信息);子标签: 当前只支持部分 exif 子标签●使用URL安全的Base64编码,当指定多个值时,使用英文状态下的 , 隔开。● 该参数不能与 exif-retain-names 一起使用 |
<exifModify> |
否 | exif 元数据修改,编码格式为: urlsafeBase64({"k1": "v1", "k2": "v2"}) , 支持的 key 列表参考修改示例 |
注意:
- 如果图片格式不支持保留某类元信息、或者原图没有某类元信息时,指定
meta-keep-list
参数后,处理结果是保留不生效,不会报错。 meta-keep-list
参数跟缩放thumbnail
参数一起使用时,保留 exif 信息不会生效。
exif 写元数据支持 key 列表
Tag 名称 | 含义 | 传值示例 |
---|---|---|
ImageWidth | 图片宽 | “100” |
ImageLength | 图片高 | “100” |
ResolutionUnit | 分辨率单位 | “2” |
XResolution | X 方向分辨率 | “72/1” |
YResolution | Y 方向分辨率 | “72/1” |
Orientation | 旋转分量 | “6” |
ExposureTime | 曝光时间 | “10/1000” |
ExposureProgram | 曝光程序 | “1” |
Flash | 闪光 | “9” |
UserComment | 自定义信息,一般为字符串 | “{“AIGC”: {“k1”: “v1”}}” |
Make | 设备生产商 | “xiaomi” |
Model | 设备名字 | “MI 6X” |
Artist | 拍摄者 | “Test” |
Copyright | 版权信息 | “Copyright, Test.” |
DateTime | 文件创建时间 | “2024:01:01 08:00:00” |
DateTimeDigitized | 照片数字化存储时间 | “2024:01:01 08:00:00” |
DateTimeOriginal | 照片生成时间 | “2024:01:01 08:00:00” |
GPSLatitudeRef | 纬度方向 | “N” 或 “S” |
GPSLatitude | 纬度(度/分/秒) | “10/1 20/1 40/1” |
GPSLongitudeRef | 经度方向 | “E” 或 “W” |
GPSLongitude | 经度(度/分/秒) | “10/1 20/1 40/1” |
GPSAltitudeRef | 高度方向 | “0” 或 “1” |
GPSAltitude | 高度 | “10/1” |
使用示例
1.去除图片的全部元信息
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/strip
2.指定保留图片icc信息,其他信息尽量保留
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/meta-keep-list/aWNj
3.指定保留图片icc信息,其他信息删除
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/strip/meta-keep-list/aWNj
4.指定保留图片exif信息,其他信息尽量保留
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/meta-keep-list/ZXhpZg==
5.指定保留图片icc信息和exif信息,其他信息删除
https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/strip/meta-keep-list/ZXhpZixpY2M=
操作方式
您可以通过 同步处理、持久化处理、图片样式设置、CDN中间源处理 等方式,对图片进行处理,详情介绍请参见图片处理操作方式。
文档反馈
(如有产品使用问题,请 提交工单)