You need to enable JavaScript to run this app.
导航
图片编辑数据结构
最近更新时间:2024.04.12 10:20:56首次发布时间:2022.08.26 14:55:41

基础功能

操作
操作名称
参数名称
参数类型是否必填参数描述
亮度brightbrightFloat调整图片亮度,取值范围为[-100, 100]。
对比度contrastcontrastFloat调整图片对比度,取值范围为[-100, 100]。
负片invert---指定时即可使用负片效果,其效果暂不支持更改配置。
锐化sharpensharpenFloat锐化图片,取值范围为[0,100]。
高斯模糊blursigmaFloat高斯模糊图片,取值 > 0,值越大图像越模糊。
旋转rotateangleFloat旋转图片角度,取值范围为[0, 360]。
bgcolorString旋转后填充的背景色,以 # 开始,后面跟 RGB 的十六进制值。
bgalphaInteger旋转后填充背景色的透明度,取值范围为[0, 100]。

翻转

flip

flip

Integer

图片内容的翻转类型,取值如下所示:

  • 1:水平翻转图片;
  • 2:垂直翻转图片。
缩放resizewidthInteger缩放后图片的宽,取值为0表示按照宽高比自适应。
heightInteger缩放后图片的高,取值为0表示按照宽高比自适应。

keepratio

bool

缩放后是否保持原图宽高比。取值如下所示:

  • true:保持原图宽高比;
  • false:不保持原图宽高比。

mode

String

keepratio取值为true时必选的等比缩放模式,取值如下所示:

  • contain:结果图宽高均不超过设置值,缩放图限制为设置宽高矩形容器内最大图;
  • cover:结果图宽或高超过设置值,缩放图为延伸出设置宽高矩形容器框外最小图。

policy

Integer

缩放适配,取值如下所示:

  • 0:表示缩放均可;
  • 1:表示只放大图片;
  • 2:表示只缩小图片。

裁剪

crop

crop

Integer

裁剪方式,取值如下所示:

  • 1:居上裁剪;
  • 2:居下裁剪;
  • 3:居左裁剪;
  • 4:居右裁剪;
  • 5:居中裁剪;
  • 6:按坐标裁剪;
  • 9:内切圆裁剪;
  • 11:定向裁剪。
widthInteger裁剪后图像宽度,仅当选择定向裁剪时可设置,若裁剪宽度不指定,默认为 0,即为原图宽度。
heightInteger裁剪后图像高度,仅当选择定向裁剪时可设置,若裁剪高度不指定,默认为 0,即为原图高度。
lxInteger确定最终裁剪范围,仅按坐标裁剪时有效,(lx, ly)表示裁剪区域左上角坐标。
lyInteger确定最终裁剪范围,仅按坐标裁剪时有效,(lx, ly)表示裁剪区域左上角坐标。
rxInteger确定最终裁剪范围,仅按坐标裁剪时有效,(rx, ry)表示裁剪区域右下角坐标。
ryInteger确定最终裁剪范围,仅按坐标裁剪时有效,(rx, ry)表示裁剪区域右下角坐标。

radius

Integer

内切圆半径。仅当选择内切圆裁剪时设置有效,取值为整数,取值范围为[1,2048]。

  • 如果指定半径大于原图最大内切圆的半径,则圆的大小仍然是图片的最大内切圆。
  • 如果图片的最终格式是 png、webp 等支持透明通道的格式,则图片非圆形区域的地方将以透明填充。如果图片的最终格式是 jpg,则非圆形区域是以白色进行填充。推荐您保存成 png 格式。
fix_crop_locInteger定向裁剪的原点位置。默认位于左上角,具体图片分布请见下图

fix_crop_x

Integer

定向裁剪的 X 方向偏移量,默认左上角为原点,取值范围为[0,图片边界]。
取值如下所示:

  • X > 0:向右偏移;
  • X < 0:向左偏移。

fix_crop_y

Integer

定向裁剪的 Y 方向偏移量,默认左上角为原点,取值范围为[0,图片边界]。
取值如下所示:

  • Y > 0:向下偏移;
  • Y < 0:向上偏移。
gravityString指定定向裁剪时的裁剪原点位置使用 URL 输入方式,取值固定为 ${crop_gravity}。您可在获取结果图地址后在 URL 中自由指定裁剪位置。
贴边裁剪trimv2lmarginInteger图片内容左侧保留像素,即设置的边框距离原图中内容的距离,默认为 0。
rmarginInteger图片内容右侧保留像素,即设置的边框距离原图中内容的距离,默认为 0。
tmarginInteger图片内容上侧保留像素,即设置的边框距离原图中内容的距离,默认为 0。
bmarginInteger图片内容下侧保留像素,即设置的边框距离原图中内容的距离,默认为 0。
minwInteger图片最小输出宽度。默认为 0,单位为 px,表示原图的宽。
与最小输出高度决定输出处理最小图片,若裁剪图大于该设置值时,输出裁剪图;裁剪图小于设置值时,将以原图的背景色补充剩余图片位置输出处理图。
minhInteger图片最小输出高度。默认为 0,单位为 px,表示原图的高。
与最小输出宽度决定输出处理最小图片,裁剪图大于该设置值时,输出裁剪图;裁剪图小于设置值时,将以原图的背景色补充剩余图片位置输出处理图。

智能人脸裁剪

smartv2

scene

String

裁剪场景。取值如下所示:

  • normal:普通人脸裁剪;
  • cartoon:动漫人脸裁剪。
widthInteger裁剪后图片的宽,单位为 px。默认为 0,表示原图的宽和高。当图片小于设置的宽高时,将不被裁剪。
heightInteger裁剪后图片的高,单位为 px。默认为 0,表示原图的宽和高。当图片小于设置的宽高时,将不被裁剪。

policy

Integer

当裁剪失败时如何降级,取值如下所示:

  • 1:居中裁剪;
  • 2:高斯模糊;
  • 3:居上裁剪。
sigmaInteger高斯模糊参数。
图文水印watermarkpic.uriString上传的水印图片 URI,缺省情况下则不加图片水印。
pic.opacityInteger水印图片的透明度,取值范围为[0, 100]。

text.location

Integer

增加图文水印时文本水印相对于图片水印的位置。取值如下所示:

  • 0:在图片水印右侧,缺省情况下默认为图片水印右侧;
  • 1:在图片水印左侧;
  • 2:在图片水印上侧;
  • 3:在图片水印下侧。
text.dxInteger文本水印相对于图片水印的水平偏移。
text.dyInteger文本水印相对于图片水印的垂直偏移。

text.content

String

文本水印内容。
缺省情况下则不加文本水印。如果通过 URL 参数传入,需要事先经过 Base64 URL Safe 编码。

text.fontString文本水印字体。支持传入的字体请参考支持字体列表。缺省情况下默认使用思源黑体。
text.sizeInteger文本的字号,单位为磅,不传或者传 0 则使用默认值 30。最大值为 200。
text.colorString文本颜色,以 # 开始,后面跟 RGB 的十六进制值。不传或者传空则默认使用白色。
text.opacityInteger文本水印的透明度,取值范围为[0, 100]。

text.align

Integer

多行文本对齐方式。取值如下所示:

  • 0:表示左对齐;
  • 1:表示居中对齐;
  • 2:表示右对齐。
text.linespaceFloat多行文本行间距,为相对与单行文本高度的比例。
text.shadowBool文本是否有阴影,缺省情况下表示不带阴影。
text.shadow.colorString文本阴影颜色,以 # 开始,后面跟 RGB 的十六进制值。不传或者传空则默认使用黑色。
text.shadow.opacityInteger文本阴影的透明度,取值范围为[0, 100]。
text.shadow.blurFloat文本阴影的高斯模糊值,取值 > 0,值越大则越模糊。
text.shadow.dxInteger文本阴影的水平偏移,负值表示阴影在文本左侧,正值表示阴影在文本右侧。偏移的绝对值不能超过5。
text.shadow.dyInteger文本阴影的垂直偏移,负值表示阴影在文本上侧,正值表示阴影在文本下侧。偏移的绝对值不能超过5。
water.angleFloat图文水印的角度,取值范围为[0, 360]。
water.fullBool是否开启水印铺满,不传表示仅在 adapt.location 处展示水印。
full.xratioFloat水印铺满 X 向间距 = 水印宽 * xratio,传 0 或不传表示 X 向间距为 0。
full.yratioFloat水印铺满 Y 向间距 = 水印高 * yratio,传 0 或不传表示 Y 向间距为 0。

water.random

Bool

图文水印位置是否为随机,默认不随机。取值如下所示:

  • true:位置随机;
  • false:位置不随机。
adapt.locationInteger图文水印所在位置编号,将图片划分为 9 宫格,从左到右,从上到下,依次从 1 到 9 编号。如下图所示。

adapt.xym_same

Bool

水平和垂直边距是否保持相同,取值如下所示:

  • true:表示保持边距相等;
  • false:表示不保持边距相等。
adapt.wratioFloat图文水印相对于底图的宽度最小值。自适应公式搭配wratiowratio_max值,设置水印相对底图的宽度。
adapt.wratio_maxFloat图文水印相对于底图的宽度最大值。 自适应公式搭配wratiowratio_max值,设置水印相对底图的宽度。
adapt.xmratioFloat相对位置下图文水印水平边距,取值范围为[0,1]。
adapt.ymratioFloat相对位置下图文水印垂直边距系数,取值范围为[0,1]。
adapt.xm_maxInteger图文水印水平边距最大值。传 0 或者不传表示无限制。
adapt.ym_maxInteger图文水印垂直边距最大值。传 0 或者不传表示无限制。
adapt.dxInteger绝对位置下图文水印距离底图的水平边距,超出底图水印部分不显示。
adapt.dyInteger绝对位置下图文水印距离底图的垂直边距,超出底图水印部分不显示。

圆角矩形

round-corner

type

String

圆角类型,取值如下所示:

  • circle:圆
  • ellipse:椭圆
radiusInteger仅当type取值为circle时代表圆角半径。
radius_xInteger仅当type取值为ellipse时代表椭圆半长轴长度。
radius_yInteger仅当type取值为ellipse时代表椭圆半短轴长度。
饱和度saturationsaturationFloat图片饱和度,取值范围为[-100,100]。
当输入值为 0 时饱和度不变,当输入值为 -100 时图像为灰度图。

图片打码

mosaic

loc

Integer

打码位置,取值如下所示:

  • 0:全图
  • 1:指定位置
bboxArray[Integer]指定打码位置时左上角与右下角坐标值。4 个为一组,表示矩形位置,[x0,y0,x1,y1]

type

Integer

打码类型,取值如下所示:

  • 0:像素格
  • 1:指定图片

shape

Integer

打码形状,取值如下所示:

  • 0:正方形
  • 1:椭圆形
uriString待打码图片存储 URI。
stepxInteger像素格宽,单位为 px,值越大越模糊。
stepyInteger像素格高,单位为 px,值越大越模糊。

附加组件

请在控制台开通指定的附加组件能力后,再创建对应能力的图片模板。

操作
操作名称
参数名称
参数类型是否必填参数描述

漫画风

comic

can_demotion

Boolean

降级设置,取值如下所示:

  • false:(默认)优先响应漫画效果;
  • true:优先响应原图。

save_tos

Boolean

是否存储结果图,取值如下所示:

  • false:(默认)不存储
  • true:存储
图像降噪denoisemodeString模型,默认为 general_model,即通用模型。
intensityFloat降噪强度,取值范围为[0,1]。取值为0时表示不降噪,取值越大降噪强度越大。

can_demotion

Boolean

降级设置,取值如下所示:

  • false:(默认)优先返回处理后的图片;
  • true:优先响应原图
画质评分qualityratioInteger采样率,取值范围为[0,100],取值为0时则代表源站请求均不会进入打分环节,取值为 100 时代表默认源站请求全部会进入打分环节。

types

String

画质评估项,取值如下所示:

  • vqscore: 主观质量
  • aesthetic:大众美学
  • noise:噪声强度

图像超分辨率

super_resolution

mode

Integer

超分模型,取值如下所示:

  • 0:超分普通模型
  • 1:超分增强模型
  • 2:超分 VR 模型

can_demotion

Boolean

降级设置,取值如下所示:

  • false:(默认)优先返回处理后的图片;
  • true:优先响应原图

long_max

Float

仅当满足图像边界输入的图像执行超分处理,超分允许处理的长边范围最大值。取值为 0 时,代表忽略输入限制。

long_minFloat仅当满足图像边界输入的图像执行超分处理,超分允许处理的长边范围最小值。取值为 0 时,代表忽略输入限制。
short_maxFloat仅当满足图像边界输入的图像执行超分处理,超分允许处理的短边范围最大值。取值为 0 时,代表忽略输入限制。
short_minFloat仅当满足图像边界输入的图像执行超分处理,超分允许处理的短边范围最小值。取值为 0 时,代表忽略输入限制。

multiple

Float

输出倍率。

  • mode取值为0/1时,该值的取值范围为[2,8]的整数。
  • mode取值为2时,该值的取值范围为[1,2],支持两位小数,超过 3k * 6k 的图片仅支持 1 倍超分。

policy

Integer

图像边界输入的逻辑计算方式,取值如下所示:

  • 0:同时满足长边和短边要求
  • 1:任意满足长边或短边要求

save_tos

Boolean

是否存储结果图,取值如下所示:

  • false:(默认)不存储
  • true:存储

denoise_ratio

Float

mode取值为2时,必填

仅当mode取值为2时,支持设置该值。
降噪强度,取值范围为(0, 1)。

sharp_ratio

Float

mode取值为2时,必填

仅当mode取值为2时,支持设置该值。
锐化强度,取值范围为(0, 1)。

集智瘦身

slim

can_demotion

Boolean

是否允许降级,取值如下所示:

  • false:优先返回处理后的图片;
  • true:优先响应原图
modeInteger模型,固定取值为0,表示通用瘦身模型。

save_tos

Boolean

是否存储结果图,取值如下所示:

  • false:(默认)不存储
  • true:存储
    asynctrue 时,本项必须为 true。

async

Boolean

是否首次访问直接降级

  • false:(默认)首次访问不直接降级
  • true:首次访问直接降级

智能背景移除

segment

can_demotion

Boolean

是否允许降级,取值如下所示:

  • false:优先返回处理后的图片;
  • true:优先响应原图

mode

Integer

处理模式:取值如下所示:

  • 0:粗线条处理,效率更优;
  • 1:发丝级细线条处理,效果更优

object_class

Integer

处理模型,取值如下所示:

  • 0:通用模型
  • 1:人像模型v1
  • 2:商品模型v1
  • 3:人像模型v2
  • 4:商品模型v2

save_tos

Boolean

是否存储结果图,取值如下所示:

  • false:(默认)不存储
  • true:存储

contour_color

String

仅当object_class取值 3/4 时,为必填。
描边颜色。支持以 HEX、HSL、RGP 表示。例如HEX中白色为#FFFFFF

contour_size

Integer

仅当object_class取值 3/4 时,为必填。
描边粗细。单位为 px。取值范围为 0 到正整数,默认 10px。

盲水印hidden_markinfoString水印内容。不超过 16 字。

strength

Integer

算法强度,强度越高,图像抵抗攻击性能越强。 取值如下所示:

  • low:低强度,适用于纯色图场景以及对图像质量要求高;
  • medium:中强度,默认中强度;
  • strong:高强度,适合图像纹理丰富时使用。

algorithm

Integer

算法模型,取值如下所示:

  • default:文本嵌入模型,默认文本嵌入模型;
  • adapt_resize:画质自适应文本嵌入模型。
图像修复erasev2modelString修复模型,固定取值为eraser_model_imagex_0.1.0,即自动检测并擦除类型模型。

bbox

List Of 0..1

处理范围矩形框。
长度为 4 的 0-1 浮点数数组

user_ocr

list

是否指定文本擦除,取值如下所示:

  • 0:(默认值)关闭
  • 1:开启。仅当开启后,匹配模式和匹配文本才会生效。

ocr_mode

list

匹配模式,仅支持取值为 1,表示模糊匹配。

  • 若输入文字内容,则擦除目标区域内包含该文字的对应文本行全部内容;
  • 若不输入文字内容,则擦除目标区域内所有检测到的文字内容。
textlist匹配文本

图像增强

enhance

mode

Integer

模型,取值如下所示:

  • 0:通用模型
  • 1:低质专清模型
  • 3:画质优化模型

can_demotion

Boolean

是否允许降级,取值如下所示:

  • false:优先返回处理后的图片;
  • true:优先响应原图

save_tos

Boolean

是否存储结果图,取值如下所示:

  • false:(默认)不存储
  • true:存储

adapt_enhance

can_demotion

Boolean

是否允许降级,取值如下所示:

  • false:优先返回处理后的图片;
  • true:优先响应原图

save_tos

Boolean

是否存储结果图,取值如下所示:

  • false:(默认)不存储
  • true:存储
actionsArray of actions高级处理配置

actions

参数名称参数类型是否必填参数描述

Name

String

自适应增强处理场景,取值如下所示:

  • face_enhance:人脸增强
  • low_quality:低质增强
  • low_quality_deblur:低质增强-去模糊化
  • super_resolution:图像超分
ParamArray of Params具体参数配置

Params

参数名称参数类型是否必填参数描述

face_cnt_max

String

Nameface_enhance 时,为必填。
最大处理人脸数量。

  • 取值为大于 0 的整数,默认值为 3。
  • 图像中人脸数目大于输入值时不执行增强,返回原图。

low_quality.long_max

Integer

Name 为 low_quality 时,为必填。
处理支持的最长边

low_quality.long_min

Integer

Namelow_quality 时,为必填。
处理支持的最短边

low_quality_deblur.face_cnt_max

String

Namelow_quality_deblur 时,为必填。
最大处理人脸

  • 取值为大于等于 -1 的整数。
  • 默认人脸数量值为 -1,表示图像内人脸都执行增强。
  • 图像人脸数目大于输入值时不执行增强,返回原图。

long_max

Integer

Namesuper_resolution 时,为必填。
最长边的最大值

long_min

Integer

Namesuper_resolution 时,为必填。
最长边的最小值

multipleString超分倍数,仅支持 2 倍和 4 倍,默认为 2 倍超分。4 倍超分辨率只适用于 1024 x 1024 以下分辨率图像的画质增强。

其他说明

定向裁剪原点示意图

图文水印指定位置示意图