图像打码

最近更新时间：2022.11.29 18:06:51

首次发布时间：2022.11.29 18:06:51

本文将为您介绍图像打码功能的注意事项、效果图、使用方法和案例讲解。

注意事项

控制台支持通过 URL 自定义打码位置和像素格大小。
图像打码为 veImageX 的基础图片处理功能，其计费详情请参见后付费-按量计费。

说明

在使用 URL 动态输入时，您可以通过自定义结果图访问 URL 上参数值，从而获取多种图像打码结果图。例如访问 URL 为：http(s)://域名/图片URI~tplv-x9vch4xmek-mosaic:mosaic_bbox_0,mosaic_bbox_1,mosaic_bbox_2,mosaic_bbox_3:mosaic_stepx:mosaic_stepy.png。

其中mosaic_bbox_0,mosaic_bbox_1,mosaic_bbox_2,mosaic_bbox_3为指定位置矩形框左上角及右下角坐标设置值，而mosaic_stepx,mosaic_stepy为默认像素格格宽和格高设置值。

效果图

示例图访问地址如下所示，您可在网站输入该地址并自定义打码位置以及像素格大小，查看多种打码图片效果：

http://p3-mofang.byteimg.com/tos-cn-i-x9vch4xmek/example1.png~tplv-x9vch4xmek-mosaic:498,90,933,295:12:12.png

原图	图片打码效果图

使用方法

使用控制台

Step 1：创建模板

您可以通过登录 veImageX 控制台创建模板，具体操作详情请参考新建模板。

Step 2：获取结果图访问地址

如果您已在控制台创建好模板，则在控制台获取您的结果图访问地址的具体操作请参考获取结果图 URL。

使用 OpenAPI

Step 1：创建模板

您可以通过调用 CreateImageTemplate创建您的模板，veImageX 也支持在该接口与其他功能进行组合配置创建模板。

Step 2：获取结果图访问地址

在创建模板后，您可以通过调用 GetResourceURL获取经模板处理后的结果图访问地址。

案例讲解

在调用 CreateImageTemplate 接口创建模板时，您需要设置Filters组合参数配置您的图片处理功能配置，具体的参数配置请参考图片编辑数据结构。

Name取值为mosaic：即图像打码功能名称；
Param为具体的操作参数：Key为图像打码参数名称，Value为参数设置值。

以上效果图中饱和度为 50 的Filters请求示例如下所示：

"Filters":[
      {
         "Name":"mosaic",
         "Param":{
            "loc":1,  //打码位置，0：全图；1：指定位置
            "shape":0, //打码形状，0：正方形；1：椭圆形
            "type":0,  //	打码类型，0：像素格；1：自定义马赛克图片
            "uri":"",  //自定义马赛克图片 URI
            "bbox":[
               0,
               0,
               100,
               100
            ],  //指定打码时，左上角及右下角位置坐标
            "stepx":20, //像素格宽，单位为 px，值越大越模糊强度越高。
            "stepy":20  //像素格高，单位为 px，值越大越模糊强度越高。
         }
      }
   ]

注意事项

效果图

使用方法

使用控制台

使用 OpenAPI

案例讲解