jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的智能多媒体服务保留EXIF子标签信息

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理
>图片高级处理（imageMogr2） >保留EXIF子标签信息

#  保留EXIF子标签信息

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

# **简介**

**imageMogr2** 提供一系列高级图片处理功能，本文介绍 **保留EXIF子标签信息** ，可与 **imageMogr2**
的其他参数一起使用，详细的计费说明请参见 [计费与定价
__](https://www.qiniu.com/prices/dora?source=dora)。

# **限制说明**

  * 原图格式支持： `psd`、`jpeg`、`png`、`gif`、`webp`、`tiff`、`bmp`、`avif`、`heic`
  * 输出格式限制：只支持输出`jpeg`、`png`、`webp`
  * 同步处理 
    * 原图只支持 20MB 以内的图片
    * 处理前动图帧数限制：`webp动图` 最大帧数为50，`gif` 最大帧数为 200
    * 处理前体积限制：图片 `w` 和`h`不能超过3万像素，总像素不能超过1.5亿像素
    * 处理后体积限制：图片`w`和`h` 不能超过9999像素，总像素不得超过2500w 像素。以下情况特别说明： 
      * 输出为 `webp静图` 时，图片 `w` 和 `h ` 不能超过16383像素，总像素不得超过2500w 像素
      * 仅限 `输入为webp动图格式，输出webp动图/gif动图时`，图片 `w` 和 `h ` 不能超过999像素，总像素（宽x高x帧数）不能超过3150万像素
  * 持久化处理 
    * 原图无大小限制
    * 处理前动图帧数限制：`gif`、`webp动图`，最大帧数为 500
    * 处理前体积限制：图片 `w`和`h `不能超过3万像素，总像素不能超过1.5亿像素
    * 处理后体积限制：图片 `w`和`h `不能超过14999像素，总像素不得超过6000w像素。以下情况特别说明： 
      * 输出为 `webp动图和静图` 时，图片 `w` 和 `h ` 不能超过16383像素，总像素不得超过6000w像素

# **参数说明**

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

    
    
    imageMogr2/exif-retain-names/<exifTTainNames>
              /ignore-error/<ignoreError>            
    

## 参数说明

参数名称 | 必填 | 说明  
---|---|---  
`/exif-retain-names/<exifTTainNames>` |  | **保留 EXIF子标签信息**  
● 取值范围： [标准 EXIF 标签
__](https://exiv2.org/tags.html)，使用URL安全的Base64编码，当指定多个子标签时，使用英文状态下的`,`隔开。  
● 不能与 `meta-keep-list` 一起使用  
  
`/ignore-error/<ignoreError>` |  | 主要针对图片兼容性的问题导致无法处理，取值为`1`时，则处理失败时返回原图；  
不设置此参数，默认处理失败时返回错误信息。  
  
**注意**

  * 如果图片格式不支持某类 exif 子标签、或者原图没有某类exif子标签信息时，指定 `exif-retain-names` 参数后，处理结果是保留不生效，不会报错。
  * `exif-retain-names` 跟缩放 `thumbnai` 参数一起使用时，保留EXIF信息不会生效

# **示例**

1.保留EXIF 子标签信息

    
    
    https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/exif-retain-names/RXhpZi5JbWFnZS5BcGVydHVyZVZhbHVl
    

# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)
等方式，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务图像DPI

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理
>图片高级处理（imageMogr2） >图像DPI

#  图像DPI

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

# **简介**

**imageMogr2** 提供一系列高级图片处理功能，本文介绍 **图像DPI**
，即输出分辨率主要指印刷需要的分辨率，描述的是设备输出图像时每英寸可产生的点数(dpi)。

可与 **imageMogr2** 的其他参数一起使用，详细的计费说明请参见 [计费与定价
__](https://www.qiniu.com/prices/dora?source=dora)。

# **限制说明**

  * 原图格式支持： `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万像素
  * 持久化处理 
    * 原图无大小限制
    * 处理前动图帧数限制：`gif`、`webp动图`，最大帧数为 500
    * 处理前体积限制：图片 `w`和`h `不能超过3万像素，总像素不能超过1.5亿像素
    * 处理后体积限制：图片 `w`和`h `不能超过14999像素，总像素不得超过6000w像素。以下情况特别说明： 
      * 输出为 `heic`和 `avif` 时，图片 `w`和`h `不能超过9999像素，总像素不能超过3072w像素
      * 输出为 `webp动图和静图` 时，图片 `w` 和 `h ` 不能超过16383像素，总像素不得超过6000w像素

# **参数说明**

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

    
    
    imageMogr2/density/<density>
              /ignore-error/<ignoreError>           
    

## 参数说明

参数名称 | 必填 | 说明  
---|---|---  
`density/<density>` |  | 图像DPI值的修改值范围：1-1200，默认为原图DPI值。  
`/ignore-error/<ignoreError>` |  | 主要针对图片兼容性的问题导致无法处理，取值为`1`时，则处理失败时返回原图；  
不设置此参数，默认处理失败时返回错误信息。  
  
# **示例**

  * 原图

![img](https://dora-doc.qiniu.com/gogopher.jpg)

  * 设置输出分辨率为300DPI，进行处理。
    
        https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/density/300
    

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/density/300)

# 操作方式

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)、[CDN中间源处理 __](https://developer.qiniu.com/fusion/4954/image-
optimization)等方式，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务限制图片大小

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理
>图片高级处理（imageMogr2） >限制图片大小

#  限制图片大小

最近更新时间: 2024-07-19 17:13:01

# **简介**

**imageMogr2** 提供一系列高级图片处理功能，本文介绍 **限制图片大小** ，可限制图片处理（例如缩放、压缩等）后的文件大小，可与
**imageMogr2** 的其他参数一起使用，详细的计费说明请参见 [计费与定价
__](https://www.qiniu.com/prices/dora?source=dora)。

# **限制说明**

  * 原图格式支持： `psd`、`jpeg`、`png`、`gif`、`webp`、`tiff`、`bmp`、`avif`、`heic`
  * 输出格式只支持 `jpeg`
  * 同步处理 
    * 原图只支持 20MB 以内的图片
    * 处理前动图帧数限制： `gif`最大帧数为 200
    * 处理前体积限制：图片 `w` 和`h`不能超过3万像素，总像素不能超过1.5亿像素
    * 处理后体积限制：图片`w`和`h` 不能超过9999像素，总像素不得超过2500w 像素
  * 持久化处理 
    * 原图无大小限制
    * 处理前动图帧数限制：`gif`、`webp动图`，最大帧数为 500
    * 处理前体积限制：图片 `w`和`h `不能超过3万像素，总像素不能超过1.5亿像素
    * 处理后体积限制：图片 `w`和`h `不能超过14999像素，总像素不得超过6000w像素

## 参数说明

参数名称 | 必填 | 说明  
---|---|---  
`size-limit/<sizeLimit>` |  | 限制图片转换后的大小，支持以兆字节（M）和千字节（K/k）为单位。仅对jpeg输出格式有效。  
1.支持魔法变量`$(fsize)`表示原图大小，尽量保证不超过原图，不强制。  
如：`http://developer.qiniu.com/resource/Ship.jpg?imageMogr2/format/jpeg/size-
limit/$(fsize)`  
  
2.若在尾部加上`!`，表示用转换后的图片大小与原图大小做比较，如果转换后的图片比原图小，则返回转换后的图片，否则返回原图。如：`https://dora-
doc.qiniu.com/gogopher.jpg?imageMogr2/format/jpeg/size-
limit/15k!`。这个主要用于保证返回的图片不会比原图大。  
  
**注意** ：大小限制并非绝对的，图片本身质量不同会造成一些误差，建议搭配 [strip
__](https://developer.qiniu.com/dora/8263/remove-the-meta-
information)参数使用，去除图片的一些冗余信息，会有更准确的限制效果。例如：`https://dora-
doc.qiniu.com/gogopher.jpg?imageMogr2/format/jpeg/strip/size-limit/15k!`  
  
# **示例**

  * 原图

![img](https://dora-doc.qiniu.com/gogopher.jpg)

  * 将 jpg 图片转换为 jpeg 格式，并限制图片大小为15KB，同时与原图进行对比。
    
        https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/format/jpeg/size-limit/15k!
    

![img](https://dora-doc.qiniu.com/gogopher.jpg?imageMogr2/quality/55)

# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)、[CDN中间源处理 __](https://developer.qiniu.com/fusion/4954/image-
optimization)等方式，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务图片基本信息（imageInfo）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >图片基本信息（imageInfo）

#  图片基本信息（imageInfo）

最近更新时间: 2024-04-26 11:29:00

# **简介**

图片基本信息包括图片格式、图片大小、色彩模型。

## **限制说明**

原图支持20MB以内的图片

  * 注意：原图超过20MB，可能会正常返回，但不保证结果是否正确。

# **接口规格**

    
    
    imageInfo
    

# **示例**

在Web浏览器中输入以下图片地址：

    
    
    http://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageInfo
    

返回结果（内容经过格式化以便阅读）：

    
    
    {
    size: 214513,
    format: "jpeg",
    width: 640,
    height: 427,
    colorModel: "ycbcr",
    orientation: "Top-left"
    }
    

字段名称 | 必填 | 说明  
---|---|---  
size | 是 | 文件大小，单位：Bytes  
format | 是 | 图片类型，如`png`、`jpeg`、`gif`、`bmp`等。  
width | 是 | 图片宽度，单位：像素(px)。  
height | 是 | 图片高度，单位：像素(px)。  
colorModel | 是 | 色彩模型，如`palette16`、`ycbcr`等。  
frameNumber |  | 帧数，gif 图片会返回此项。  
  
# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)、[CDN中间源处理 __](https://developer.qiniu.com/fusion/4954/image-
optimization)等方式，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务图片EXIF信息（exif）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >图片EXIF信息（exif）

#  图片EXIF信息（exif）

最近更新时间: 2022-07-28 16:47:54

# **简介**

[EXIF(EXchangeable Image File
Format)__](http://zh.wikipedia.org/wiki/Exif)是专门为数码相机的照片设定的可交换图像文件格式。

## **使用限制**

  * 缩略图等经过云处理的新图片不支持EXIF
  * 原图格式为`avif`、`heif`不支持EXIF
  * 原图只支持 20MB 以内的图片

# **接口规格**

`exif`

# **示例**

在Web浏览器中输入以下图片地址：

    
    
    http://dn-odum9helk.qbox.me/resource/gogopher.jpg?exif
    

返回结果（内容经过格式化以便阅读）：

    
    
      {
         "DateTime" : {
            "type" : 2,
            "val" : "2011:11:19 17:09:23"
         },
         "ExposureBiasValue" : {
            "type" : 10,
            "val" : "0.33 EV"
         },
         "ExposureTime" : {
            "type" : 5,
            "val" : "1/50 sec."
         },
         "Model" : {
            "type" : 2,
            "val" : "Canon EOS 600D"
         },
         "ISOSpeedRatings" : {
            "type" : 3,
            "val" : "3200"
         },
         "ResolutionUnit" : {
            "type" : 3,
            "val" : " 英寸"
         },
    
         ...后续内容已省略...
      }
    

# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)、[CDN中间源处理 __](https://developer.qiniu.com/fusion/4954/image-
optimization)等方式，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务图片圆角处理（roundPic）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >图片圆角处理（roundPic）

#  图片圆角处理（roundPic）

最近更新时间: 2023-07-17 18:09:19

# **简介**

`roundPic` 将图片生成圆角图片，并且可以指定图片的圆角大小。

## **使用限制**

  * 原图格式支持：`png`、`jpg`，处理后的图片格式为`png`

  * 同步处理

    * 只支持 20MB 以内的图片，超过 20MB 的图片需要使用持久化处理
    * 处理前的图片`w`和`h`参数不能超过3万像素，总像素不能超过1.5亿像素
    * 处理后的图片`w`和`h`参数不能超过9999像素，总像素不得超过24999999（2500w-1）像素
    * 处理后图片文件大小没有限制
  * 持久化处理

    * 图片文件无大小限制
    * 处理前的图片`w`和`h`参数不能超过3万像素，总像素不能超过1.5亿像素
    * 处理后的图片`w`和`h`参数不能超过14999像素，总像素不得超过59999999（6000w-1）像素
    * 处理后图片文件大小没有限制  
​

# **接口规格**

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

    
    
    roundPic/radius/<radius>
            /radiusx/<radiusx>
            /radiusy/<radiusy>
    

参数名称 | 必填 | 说明  
---|---|---  
`/radius/<radius>` | 否 | 圆角大小的参数，水平和垂直的值相同，可以使用像素数（如200）或百分比（如!25p）。不能与`radiusx`和`radiusy`同时使用。  
`/radiusx/<radiusx>` | 否 | 圆角水平大小的参数，可以使用像素数（如200）或百分比（如!25p）。需要与`radiusy`同时使用。  
`/radiusy/<radiusy>` | 否 | 圆角垂直大小的参数，可以使用像素数（如200）或百分比（如!25p）。需要与`radiusx`同时使用。  
  
**注意：**

1.其中当像素数大于宽（高）的1/2时取其1/2，百分比大于!50p时，取!50p；

2.像素数与百分比均需为非负值，命令`roundPic/radius/!50p`可使方形图片变圆。

# **示例**

  * 原图

![查看效果图](http://dn-odum9helk.qbox.me/resource/gogopher.jpg)

  * 把一张图片变成圆角：
    
        https://dora-doc.qiniu.com/gogopher.jpg?roundPic/radius/50
    

![查看效果图](https://dora-doc.qiniu.com/gogopher.jpg?roundPic/radius/50)

# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-
style)等方式，对图片进行处理，暂不支持`CDN中间源处理`，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务图片平均色调（imageAve）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >图片平均色调（imageAve）

#  图片平均色调（imageAve）

最近更新时间: 2021-07-23 11:30:18

# **简介**

imageAve接口用于计算一幅图片的平均色调，并以`0xRRGGBB`形式返回。

## **限制说明**

  * 同步处理

    * 原图支持 20MB 以内的图片
    * 处理前的图片`w`和`h`参数不能超过10000像素
  * 持久化处理

    * 图片文件无大小限制
    * 处理前的图片`w`和`h`参数不能超过10000像素

# 接口规格

`imageAve`

# **示例**

在Web浏览器中输入以下图片地址：

    
    
    https://o6nalx2hr.qnssl.com/0.jpg?imageAve
    

返回结果（内容经过格式化以便阅读）：

    
    
    {
        "RGB": "0x85694d"
    }
    

# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)、[CDN中间源处理 __](https://developer.qiniu.com/fusion/4954/image-
optimization)等方式，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务动图合成（animate）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >动图合成（animate）

#  动图合成（animate）

最近更新时间: 2021-07-23 11:30:33

# **简介**

动图合成接口（animate）用于将多张图片合成 GIF 动图。

## **使用限制**

  * 目前仅适用于存储在七牛的图片
  * 原图限制： 
    * 支持的格式有 jpeg 和 png
    * 支持的最大帧数为 20
    * 支持的最大图片尺寸为 1080*1080

# **接口规格**

    
    
    animate/duration/<duration>
           /merge/key/<encodedImageKey>
                 /key/<encodedImageKey>
                 ...
           /effect/<effectType>
    

## 参数说明

名称 | 必填 | 说明  
---|---|---  
`<duration>` | Y | GIF动图的每帧间隔时间(单位: 0.01s)，取值要求为大于0的整数。  
`<encodedImageKey>` | N | 合成GIF动图的源图片key(经过Base64编码)，保证所有的源图都来源于同一个bucket。  
`<effectType>` | N | 定义播放顺序，取值：0，1。（0:正序循环播放；1:倒序循环播放；）默认为0。  
  
# **操作方式**

您可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-
processing)、[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-pfop)、[图片样式设置](https://developer.qiniu.com/dora/api/8264/the-
picture-style)
等方式，暂不支持`CDN中间源处理`，对图片进行处理，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

# **服务价格**

计费方式：按调用次数计费。  
价格：0.2元/千次。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务图片全景拼接（stitch）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >图片全景拼接（stitch）

#  图片全景拼接（stitch）

最近更新时间: 2022-07-06 14:47:08

# **简介**

图片全景拼接服务（stitch），可以帮助您将多张图像拼接起来，拼成一幅大的图像来创建全景图像。

## **限制说明**

  * 原图限制

    * 输入格式仅支持 ` jpg`、`png`
    * 输入图片最大分辨率 3200*2400
    * 只支持 20MB 以内的图片
  * 最多可拼接10张图片（含源文件）

​

# **接口规格**

    
    
    stitch/format/<Format>/images/<image0>/<image1>/...
    

参数名称 | 必填 | 说明  
---|---|---  
format | 是 | 输出文件格式，支持 jpg、png  
images | 是 | 1、目前支持 kodo 资源。kodo 资源可由 `kodo://<bucketname>/<key> `表示（此时 bucketname 需要与输入源在同一区域），均需要经过`urlsafe_base64_encode`。  
2、需要和源文件一块拼接的多张图片, 最多 9 张。  
  
# **示例**

    
    
    POST /pfop/ HTTP/1.1
    Host: api.qiniu.com  
    Content-Type: application/x-www-form-urlencoded  
    Authorization: QBox <AccessToken>  
    
    bucket=test&key=boat1_1280x720.jpg&fops=stitch%2Fformat%2Fjpg%2Fimages%2FaHR0cDovL3Eyeng3YTB3Ny5ia3QuY2xvdWRkbi5jb20vYm9hdDJfMTI4MHg3MjAuanBn%2FaHR0cDovL3Eyeng3YTB3Ny5ia3QuY2xvdWRkbi5jb20vYm9hdDNfMTI4MHg3MjAuanBn&notifyURL=http%3A%2F%2Ffake.com%2Fqiniu%2Fnotify
    

  * 原图1：  
![查看效果图](https://dn-odum9helk.qbox.me/FjrKdVO3a18Z83thRRgmf13FE0oh)

  * 原图2：  
![查看效果图](https://dn-odum9helk.qbox.me/FsKv0MHulo7NB4jadBKDK-B1pE5t)

  * 原图3：  
![查看效果图](https://dn-odum9helk.qbox.me/Fka1rcchu7GuznVVIWvf9m76me-O)

  * 拼接效果图：

    
    
    https://dn-odum9helk.qbox.me/FgrMnstM96oChWztgjcylF4VET1C
    

![查看效果图](https://dn-odum9helk.qbox.me/FgrMnstM96oChWztgjcylF4VET1C)  
​

# **操作方式**

您可以通过[持久化处理](https://developer.qiniu.com/dora/api/1291/persistent-data-
processing-
pfop)，暂不支持`同步处理`，详情介绍请参见[图片处理操作方式](https://developer.qiniu.com/dora/api/8234/the-
image-processing1)。

# **计费说明**

图片规格 | 价格  
---|---  
800×600 以下 | 0.28 元/百张  
1600×1200 以下 | 0.46 元/百张  
3200×2400 以下 | 1.48 元/百张  
  
**计费示例：** 某用户拼接 800×600 以下尺寸的图片1000张，费用为`2.8元= 0.28*10`.

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务异常图片检测

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >异常图片检测

#  异常图片检测

最近更新时间: 2024-05-27 15:18:17

# **简介**

异常图片检测功能作为 avinfo 功能接口的拓展，即通过指定异常图片检测参数，可以检测图片中是否隐含其他类型的可疑文件。

## **限制说明**

  * 支持格式：JPG、JPEG、PNG、BMP、GIF、WEBP，及纯TS视频流（仅更改后缀）。

# **接口规格**

    
    
    avinfo/imageinspect/<Imageinspect>
    

## 请求参数说明

名称 | 必填 | 说明  
---|---|---  
`/imageinspect/<Imageinspect>` | N | 是否开启图片异常检测功能，取值0或1。  
默认为0，关闭启图片异常检测；  
值为1时，开启图片异常检测功能。  
  
## 响应参数说明

名称 | 说明  
---|---  
suspicious | 是否检测到图片中包含图片格式以外的文件，false 为正常图片文件，true 表示含有其他格式的可疑文件  
suspiciousBeginByte | 检测到可疑文件的起始字节位置，单位Bytes  
suspiciousSize | 检测到可疑文件的大小，单位Bytes  
suspiciousType | 检测到可疑文件的类型，例如 MPEG-TS  
  
# **操作方式**

使用方式 | 配置类型 | 说明  
---|---|---  
上传到kodo后自动触发检测 | 通过控制台配置使用 | 操作指引详见 [防黑产图片盗刷 __](https://developer.qiniu.com/dora/best_practices/12700/Anti-blackmail-image-theft)  
对kodo中存量文件进行批量检测 | 通过控制台配置使用 | 操作指引详见 [防黑产图片盗刷 __](https://developer.qiniu.com/dora/best_practices/12700/Anti-blackmail-image-theft)  
使用接口检测kodo中的单个图片 | 通过API接口使用 | 1\. 通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-processing) 的方式来调用  
2\. 通过 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-
processing-pfop)的方式来调用  
a.
`资源上传时自动触发`：可以在上传时指定[persistentOps](https://developer.qiniu.com/kodo/manual/put-
policy#put-policy-persistent-ops-explanation)参数  
b. `对已有资源手动手动触发`：调用[pfop](https://developer.qiniu.com/dora/12491/abnormal-
image-detection)命令  
  
# **示例**

    
    
    https://dora-doc.qiniu.com/gogopher.jpg?avinfo/imageinspect/1
    

将返回如下元信息（已经经过格式化，以便阅读）：

    
    
    {
    streams: [
    	{
    	  index: 0,
              codec_name: "mjpeg",
              codec_long_name: "Motion JPEG",
    	  profile: "192",
    	  codec_type: "video",
    	  codec_time_base: "0/1",
    	  codec_tag_string: "[0][0][0][0]",
              codec_tag: "0x0000",
    	  width: 640,
    	  height: 427,
    	  coded_width: 640,
    	  coded_height: 427,
    	  has_b_frames: 0,
    	  sample_aspect_ratio: "1:1",
    	  display_aspect_ratio: "640:427",
    	  pix_fmt: "yuvj444p",
    	  level: -99,
    	  color_range: "pc",
    	  color_space: "bt470bg",
    	  chroma_location: "center",
    	  refs: 1,
    	  r_frame_rate: "25/1",
    	  avg_frame_rate: "0/0",
    	  time_base: "1/25",
    	  bits_per_raw_sample: "8",
              disposition: {
    		default: 0,
    		dub: 0,
    		original: 0,
    		comment: 0,
    		lyrics: 0,
    		karaoke: 0,
    		forced: 0,
    		hearing_impaired: 0,
    		visual_impaired: 0,
    		clean_effects: 0,
    		attached_pic: 0,
    		timed_thumbnails: 0
        }
      }
    ],
    format: {
        nb_streams: 1,
        nb_programs: 0,
        format_name: "jpeg_pipe",
        format_long_name: "piped jpeg sequence",
        size: "214513",
        probe_score: 51
    },
    imageinspect: {
        suspicious: false,
        suspiciousBeginByte: " ",
        suspiciousSize: " ",
        suspiciousType: " "
    }
    }
    

# **服务价格**

类型 | 价格  
---|---  
异常图片检测 | 0.1 元/千次  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务图片样式

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 图片处理 >图片样式

#  图片样式

最近更新时间: 2024-05-10 17:49:59

对象存储 Kodo 支持通过控制台提供一键式图片编辑功能，方便您对空间（Bucket）内上传文件（Object）做批量图片处理。

您可在本多媒体样式功能中进行：

  * 图片处理：支持对图片进行如剪裁、添加水印、格式变更等的处理。图片样式将冗长的图片数据处理重新定义的一个友好别名，以简洁的方式描述对图片的处理模式。
  * 样式分隔符：样式分隔符是用于连接资源链接和图片样式的特殊符号，为防止访问出错，您可自定义样式名中不可出现的分隔符。  
  

# **说明**

  * 更多关于图片编辑的操作，请参考七牛云智能多媒体服务的[图片处理 __](https://developer.qiniu.com/dora/3683/img-directions-for-use)。
  * 更多详情请参考[图片样式](https://developer.qiniu.com/kodo/development_guidelines/8623/dev-the-picture-style)。  
  

# **操作步骤**

  1. 登录 Kodo 控制台进入[空间管理 __](https://portal.qiniu.com/kodo/bucket)界面
  2. 单击**目标空间名称** 进入空间概览，单击**多媒体样式** 进入如图1:多媒体样式列表  
图1:  
![image.png](https://dn-odum9helk.qbox.me/FgzfU35_cVSvxdl8tlxg-CuATDtX)

  3. 单击**新建样式** ，选择**图片处理** 以新建图片处理规则，如图2。  
图2:  
![image.png](https://dn-odum9helk.qbox.me/Fq_kvmXRdCHk_84XO4SXT4NVQCDx)  
或在如图3，单击**文件管理** ，选择指定图片文件，在操作栏**更多** 中的**图片样式** 点击**新建样式**
，以进入样式编辑界面（仅标准存储、低频存储和归档直读存储类型的图片文件支持）。  
图3:  
![image.png](https://dn-odum9helk.qbox.me/Fjiyf3yKVD4j0rfkl8h5zaxBRfgp)  
指定规则后，点击**保存样式** 提交新建样式请求，已新建的样式将以列表展示。图片处理参数详情请参考智能多媒体服务[图片样式
__](https://developer.qiniu.com/dora/8264/the-picture-style)。

  4. 在图2的样式配置界面中，您可以使用 Kodo 提供的默认图片并点击**预览** 进行样式效果预览。
  5. 或点击**选择样例文件** ，在如图4的文件选择界面中点击**空间内选择** 直接选择空间中已有的文件，并点击**预览** 进行样式效果预览。  
_注：仅支持选择标准存储、低频存储和归档直读存储的图片类型文件_

  6. 或在如图4的文件选择界面点击**上传文件** ，支持您直接从本地上传指定文件到您空间，并点击**预览** 以使用该文件查看预览效果。  
_注：您上传的文件将存储在您空间中，仅支持上传大小不超过 20MB 的图片文件_  
图4:  
![image.png](https://dn-odum9helk.qbox.me/FmIlZ_sBjStmVj55HzD5aa2KtUQP)

  7. 点击在列表操作栏中**编辑** ，支持对已有样式进行修改。
  8. 点击在列表操作栏中**复制** ，支持复制已有样式以在当前空间中进行快速新建。您也可以选择单/多个样式，点击**批量操作** 选择**复制到其他空间** ，快速将当前的样式复制到其他自有空间。如在批量操作中遇到样式名重复，您可以点击**覆盖** 或**取消** 复制当前样式，如图5。  
图5:  
![image.png](https://dn-odum9helk.qbox.me/Fk6M-0AU6We5tnuN7Zj0vb6jpLgH)

  9. 点击在列表操作栏中**预览** ，可以快速预览样式效果，支持选择指定预览文件查看效果。
  10. 点击在列表操作栏中**删除** ，删除已有样式。您也可以选择单/多个样式，点击**批量操作** 选择**批量删除** 完成批量删除样式的操作。

### **访问设置**

  1. 单击**访问设置** ，在如图5右侧弹窗中样式分隔符设置界面，单击**请选择样式分隔符** 栏获取下拉菜单  
图5:  
![image.png](https://dn-odum9helk.qbox.me/Fls0XhGh9zuDoWg4bnNrP7lSH69-)

  2. **单选或多选** 指定分隔符，单击 **+添加** ，单击**保存** ，完成样式分隔符设置。  
_注：未设置时默认样式分隔符为 -（中划线）_

  

# **具体示例**

  1. 样式名称为 `imageFop`，样式内容为：`imageView2/0/w/48/h/48`，样式分隔符为 `-`
  2. 原始图片链接 `http://dn-odum9helk.qbox.me/qiniu-picture1.jpg`
  3. 通过访问 `http://dn-odum9helk.qbox.me/qiniu-picture1.jpg-imageFop` 即可获得效果缩放效果  
注意事项：

     * 创建分隔符时，不建议使用在样式名称中出现的符号作为分隔符。
     * 修改分隔符是个危险操作，为保证样式访问链接生效，仅支持新增、不支持删除已设置的样式分隔符。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务文件HASH值（qhash）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 文件处理 >文件HASH值（qhash）

#  文件HASH值（qhash）

最近更新时间: 2022-06-23 15:35:30

# **简介**

文件HASH值(qhash)用于实时得到存储在七牛的文件的HASH值。

## **限制说明**

  * 该功能目前支持华东、华南、华北、北美、东南亚区域的存储 bucket。

# **接口规格**

**注意：** 接口规格不含任何空格与换行符，下列内容经过格式化以便阅读。

    
    
    qhash/<algorithm> 
    

参数名称 | 必填 | 说明  
---|---|---  
`<algorithm>` | 是 | 计算 hash 的算法。目前支持`sha1`、`md5`、`sha256`。  
  
# **示例**

**1.按md5算法计算文件的HASH值**

    
    
    http://dn-odum9helk.qbox.me/resource/gogopher.jpg?qhash/md5
    

返回结果

    
    
    {
        "hash": "6085d57b5ee06ac7f793fa5f0f052cb5",
        "fsize": 214513
    }
    

**2.按sha1算法计算文件的HASH值**

    
    
    http://dn-odum9helk.qbox.me/resource/gogopher.jpg?qhash/sha1
    

返回结果

    
    
    {
        "hash": "1f3156aa1dd8c4359a871f2384b82a944be83f7c",
        "fsize": 214513
    }
    

**3.按sha256算法计算文件的HASH值**

    
    
    http://dn-odum9helk.qbox.me/resource/gogopher.jpg?qhash/sha256
    

返回结果

    
    
    {
        "hash": "9806aa869d6f9d285164b0ce901e49f56cc915791814de231d41759548a2ee28",
        "fsize": 214513
    }
    

# **操作方式**

  * 可以通过 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-processing-pfop)的方式来调用：
    * `资源上传时自动触发`：可以在上传时指定[persistentOps](https://developer.qiniu.com/kodo/manual/put-policy#put-policy-persistent-ops-explanation)参数
    * `对已有资源手动手动触发`：调用[pfop](https://developer.qiniu.com/dora/1297/file-hash-value-qhash)命令
  * 可以通过 [同步处理](https://developer.qiniu.com/dora/api/8266/synchronous-processing) 的方式来调用。

以上内容是否对您有帮助？
human: 如何处理七牛云的智能多媒体服务文本文件合并（concat）

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 文件处理 >文本文件合并（concat）

#  文本文件合并（concat）

最近更新时间: 2021-07-26 17:38:05

# **简介**

文本文件合并接口(concat)用于将数个七牛云上的源文件的二进制内容按指定顺序合并到新文件。

## **限制说明**

  * 不能用于[音视频拼接](https://developer.qiniu.com/dora/api/audio-and-video-stitching-avconcat)和图片拼接。
  * 本接口只能以 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-processing-pfop)形式来使用。

# **接口规格**

**注意** ：接口规格不含任何空格与换行符，下列内容经过格式化以便阅读。

    
    
    Url1?concat/mimeType/<encodedMimeType>
                /<encodedUrl2>             
                /<encodedUrl3>             
                /<encodedUrl4>             
                /...                      
    

参数名称 | 必填 | 说明  
---|---|---  
Url1 | 是 | 第一个源文件的完整URL，无需经过URL安全的Base64编码。例如：`http://oano6er4n.bkt.clouddn.com`  
encodedMimeType | 是 | 目标文件的MIME类型，必须填经过[URL安全的Base64编码](https://developer.qiniu.com/kodo/manual/appendix#urlsafe-base64)的值  
encodedUrlN | 是 | ● 必须是源文件完整的URL经过URL安全的Base64编码的值  
● 所有源文件必须在同一个存储空间  
● 最多可以合并1000个文件  
● 文件内容按照文件名顺序合并  
  
# **操作方式**

文本文件合并，目前只能以 [持久化处理 __](https://developer.qiniu.com/dora/1291/persistent-data-
processing-pfop)形式来使用。

# **示例**

以 `对已有资源手动触发` 形式，将多个文本文件拼接成一个（分别是 a.txt、b.txt 和 c.txt 在同一个空间中，并且绑定域名
test.clouddn.com）

    
    
    POST /pfop HTTP/1.1
    Host: api.qiniu.com
    Content-Type: application/x-www-form-urlencoded
    Authorization: QBox <AccessToken>
    
    bucket=qiniu-ts-demo
    &key=a.txt
    &fops=concat/mimeType/dGV4dC9wbGFpbg==/aHR0cDovL3Rlc3QuY2xvdWRkbi5jb20vYi50eHQ=/aHR0cDovL3Rlc3QuY2xvdWRkbi5jb20vYy50eHQ=&notifyURL=http://fake.com/qiniu/notify
    

**注意** ：要在 Authorization 头部的 `<AccessToken>` 前添加 QBox 和半角空格。

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