接口说明

更新时间：2022-06-29

图像无损放大

输入一张图片，可以在尽量保持图像质量的条件下，将图像在长宽方向各放大两倍。 None

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用图像无损放大 """
client.imageQualityEnhance(image)

图像无损放大请求参数详情

参数名称	是否必选	类型	说明
image	是	string	图像数据，base64编码，要求base64编码后大小不超过4M，长宽乘积不超过1600p x 1600px,支持jpg/png/bmp格式

图像无损放大返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	base64编码图片

图像无损放大返回示例

{
    "log_id":739539874,
    "image":"base64str"
}

图像去雾

对浓雾天气下拍摄，导致细节无法辨认的图像进行去雾处理，还原更清晰真实的图像。 None

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用图像去雾 """
client.dehaze(image)

图像去雾请求参数详情

参数名称	是否必选	类型	说明
image	是	string	图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式

图像去雾返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	base64编码图片

图像去雾返回示例

{
    "log_id":739539874,
    "image":"base64str"
}

图像对比度增强

调整过暗或者过亮图像的对比度，使图像更加鲜明。 None

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用图像对比度增强 """
client.contrastEnhance(image)

图像对比度增强请求参数详情

参数名称	是否必选	类型	说明
image	是	string	图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式

图像对比度增强返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	base64编码图片

图像对比度增强返回示例

{
    "log_id":739539874,
    "image":"base64str"
}

黑白图像上色

智能识别黑白图像内容并填充色彩，使黑白图像变得鲜活。 None

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用黑白图像上色 """
client.colourize(image)

黑白图像上色请求参数详情

参数名称	是否必选	类型	说明
image	是	string	图像数据base64编码大小不超过4M，最短边至少64px，最长边最大800px，长宽比3：1以内,支持jpg/png/bmp格式

黑白图像上色返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	base64编码图片

黑白图像上色返回示例

{
    "log_id":739539874,
    "image":"base64str"
}

拉伸图像恢复

自动识别过度拉伸的图像，将图像内容恢复成正常比例。 None

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用拉伸图像恢复 """
client.stretchRestore(image)

拉伸图像恢复请求参数详情

参数名称	是否必选	类型	说明
image	是	string	图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式

拉伸图像恢复返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	base64编码图片

拉伸图像恢复返回示例

{
    "log_id":739539874,
    "image":"base64str"
}

图像风格转换

可将图像转化成卡通画、铅笔画、彩色铅笔画，或者哥特油画、彩色糖块油画、呐喊油画、神奈川冲浪里油画、奇异油画、薰衣草油画等共计9种风格，可用于开展趣味活动，或集成到美图应用中对图像进行风格转换。

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用图像风格转换, 图片参数为本地图片"""
client.styleTrans(image);

""" 如果有可选参数 """
options['option'] = "cartoon"

""" 调用图像风格转换, 图片参数为本地图片 """
client.styleTrans(image, options)

图像风格转换请求参数详情

参数	是否必选	类型	可选值范围	说明
image	true	string	-	base64编码后大小不超过4M，像素乘积不超过20002000，最短边至少50px，最长边最大4096px，长宽比3:1以内。注意：图片的base64编码是不包含图片头的，如`（data:image/jpg;base64,）`*
option	true	string	cartoon pencil color_pencil warm wave lavender mononoke scream gothic	cartoon：卡通画风格 pencil：铅笔风格 color_pencil：彩色铅笔画风格 warm：彩色糖块油画风格 wave：神奈川冲浪里油画风格 lavender：薰衣草油画风格 mononoke：奇异油画风格 scream：呐喊油画风格 gothic：哥特油画风格

图像风格转换返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	base64编码图片

图像风格转换返回示例

{
    "log_id":739539874,
    "image":"base64str"
}

人物动漫化

运用世界领先的对抗生成网络，结合人脸检测、头发分割、人像分割等技术，为用户量身定制千人千面的二次元动漫形象，并且可通过参数设置，生成戴口罩的二次元动漫人像

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用人物动漫化 """
client.selfieAnime(image)

""" 如果有可选参数 """
options['type'] = "anime"
options['mask_id'] = 3

""" 调用人物动漫化, 图片参数为本地图片 """
client.selfieAnime(image, options)

人物动漫化请求参数详情

参数	是否必选	类型	可选值范围	说明
image	true	string	-	需要处理的图片base64编码后大小不超过4M，最短边至少64px，最长边最大4096px，长宽比3：1以内。注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）
type	false	string	-	anime或者anime_mask。前者生成二次元动漫图，后者生成戴口罩的二次元动漫人像
mask_id	false	int	1-8	在type参数填入anime_mask时生效，1～8之间的整数，用于指定所使用的口罩的编码。type参数没有填入anime_mask，或mask_id 为空时，生成不戴口罩的二次元动漫图。

人物动漫化返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	处理后图片的Base64编码

人物动漫化返回示例

{
     "log_id":739539874,
     "image":base64str
}

天空分割

可智能分割出天空边界位置，输出天空和其余背景的灰度图和二值图，可用于图像二次处理，进行天空替换、抠图等图片编辑场景。

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用天空分割 """
client.skySeg(image)

天空分割请求参数详情

参数	是否必选	类型	可选值范围	说明
image	true	string	-	图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少64px，最长边最大2049 px，像素乘积不超过20492049，长宽比3：1以内，支持jpg/png/bmp格式。注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）去掉编码头后再进行urlencode。*

天空分割返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
scoremap	否	string	分割结果的灰度图，base64编码字符串。每个像素的取值范围是0-255的整数，可以近似于概率，值越大表示越可能是天空。
labelmap	否	string	分割结果的二值图，base64编码字符串。每个像素值是0或1，0表示背景，1表示天空。

天空分割返回示例

{
    "labelmap": "处理后图片的二值图base64编码字符串",
    "log_id": "1262724512684703744",
    "scoremap": "处理后图片的灰度图base64编码字符串",
    "type": "sky"
}

图像清晰度增强

对压缩后的模糊图像实现智能快速去噪，优化图像纹理细节，使画面更加自然清晰

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用图像清晰度增强 """
client.imageDefinitionEnhance(image)

图像清晰度增强请求参数详情

参数名称	是否必选	类型	说明
image	是	string	需要处理的图片base64编码后大小不超过4M，最短边至少64px，最长边最大4096px，长宽比3：1以内，像素乘积不超过 1280*720。注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）

图像清晰度增强返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	否	string	base64编码图片

图像清晰度增强返回示例

{
    "log_id":739539874,
    "image":"base64str"
}

图像修复

去除图片中不需要的遮挡物，并用背景内容填充，提高图像质量。

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

# 注意：上传宽高、位置坐标参数要比图片实际宽高小
rectangle = [{'width': 92, 'top': 25, 'height': 36, 'left': 543}]

""" 调用图像修复 """
client.inpaintingByMask(image, rectangle)

""" 如果有可选参数 """
options = {}

""" 调用图像修复, 图片参数为本地图片 """
client.inpaintingByMask(image, rectangle, options)

图像修复请求参数详情

参数	是否必选	类型	可选值范围	说明
rectangle	true	array[]	[{'width': 92, 'top': 25, 'height': 36, 'left': 543}]	要去除的位置为规则矩形时，给出坐标信息，每个元素包含left, top, width, height，int 类型。
image	true	string	-	被修复的图片base64编码后大小不超过4M，最短边至少100px，最长边最大2000px，长宽比3：1内。注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）

图像修复返回数据参数详情

字段	是否必选	类型	说明
log_id	是	uint64	唯一的log id，用于问题定位
image	是	string	修复后的base64编码图片

图像修复返回示例

{
    "log_id":739539874,
    "image":"base64str"
}