智能多媒体服务

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

    元信息保留与去除

    最近更新时间: 2024-07-19 17:12:25

    简介

    imageMogr2 提供一系列高级图片处理功能,本文介绍 图片元信息保留与去除 的使用,可与 imageMogr2 的其他参数一起使用,详细的计费说明请参见 计费与定价

    • 图片元信息包括:bKGD、cHRM、EXIF、gAMA、iCCP、iTXt、sRGB、tEXt、zCCP、zTXt、date等

    限制说明

    • 原图格式支持: psdjpegpnggifwebptiffbmpavifheic
    • 同步处理
      • 原图只支持 20MB 以内的图片
      • 处理前动图帧数限制:webp动图 最大帧数为50,gif 最大帧数为 200
      • 处理前体积限制:图片 wh不能超过3万像素,总像素不能超过1.5亿像素
      • 处理后体积限制:图片wh 不能超过9999像素,总像素不得超过2500w 像素。以下情况特别说明:
        • 输出为 avif 时,图片 wh 不能超过9999像素,总像素不能超过768w像素
        • 输出为 webp静图 时,图片 wh 不能超过16383像素,总像素不得超过2500w 像素
        • 仅限 输入为webp动图格式,输出webp动图/gif动图时,图片 wh 不能超过999像素,总像素(宽x高x帧数)不能超过3150万像素
    • 持久化处理
      • 原图无大小限制
      • 处理前动图帧数限制:gifwebp动图,最大帧数为 500
      • 处理前体积限制:图片 wh 不能超过3万像素,总像素不能超过1.5亿像素
      • 处理后体积限制:图片 wh 不能超过14999像素,总像素不得超过6000w像素。以下情况特别说明:
        • 输出为 heicavif 时,图片 wh 不能超过9999像素,总像素不能超过3072w像素
        • 输出为 webp动图和静图 时,图片 wh 不能超过16383像素,总像素不得超过6000w像素

    参数说明

    注意:接口规格不含任何空格与换行符。

    imageMogr2/strip
              /meta-keep-list/<metaKeepList>
              /ignore-error/<ignoreError>           
    

    参数说明

    参数名称 必填 说明
    /strip 去除图片的全部元信息
    strip 参数单独使用

    保留指定的图片元信息,其他信息删除
    stripmeta-keep-list 参数一起使用,即 strip/meta-keep-list
    /meta-keep-list/<metaKeepList> 保留指定的图片元信息,其他信息尽量保留 (参数单独使用时)
    ● 取值范围: icc (色彩信息)、exif (exif 信息),使用URL安全的Base64编码,当指定多个值时,使用英文状态下的, 隔开。
    ● 该参数不能与 exif-retain-names 一起使用。
    /ignore-error/<ignoreError> 主要针对图片兼容性的问题导致无法处理,取值为1时,则处理失败时返回原图;
    不设置此参数,默认处理失败时返回错误信息。

    注意

    • 如果图片格式不支持保留某类元信息、或者原图没有某类元信息时,指定meta-keep-list参数后,处理结果是保留不生效,不会报错。

    • meta-keep-list 参数跟缩放 thumbnai 参数一起使用时,保留exif信息不会生效。

    使用示例

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

    以上内容是否对您有帮助?
  • Qvm free helper
    Close