智能多媒体服务

    • 智能多媒体服务 > API 文档 > 图片处理 >图片高级处理（imageMogr2） >元信息保留与去除

    元信息保留与去除

    最近更新时间: 2025-09-10 16:38:04

    简介

    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中间源处理 等方式，对图片进行处理，详情介绍请参见图片处理操作方式。

    以上内容是否对您有帮助？