{ "openapi": "3.0.3", "info": { "title": "达摩院-图像生产", "description": "基于阿里云深度学习技术，提供图像视觉质量增强、图像内容编辑与质量评分等生产能力。图像生产服务可灵活应用于摄影、艺术、广告、媒体等行业，满足老照片修复、图像去噪、图像质量矫正与图像评分等业务需求。", "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2", "version": "1.0.0" }, "servers": [ { "url": "https://route.showapi.com" } ], "paths": { "/2585-19": { "x-pointCode": 19, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像曝光度评分", "description": "可以检测输入图像，输出图像的曝光度评分。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、BMP、PNG。\n图片分辨率：分辨率要求小于1000×1000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Exposure": { "type": "number", "description": "输出图像曝光度评分，取值范围0~1。评分越高表示曝光度越大。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_19_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "输入图片URL地址" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2585-18": { "x-pointCode": 18, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像清晰度评分", "description": "可以检测输入图像，输出图像的曝光度评分。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、BMP、PNG。\n图片分辨率：分辨率要求小于1000×1000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Sharpness": { "type": "number", "description": "输出图像清晰度评分，取值范围0~1。评分越高图像越清晰。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_18_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "输入图片URL地址" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2585-17": { "x-pointCode": 17, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像构图美学评分", "description": "可以检测输入图像，输出图像的构图美学评分。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、BMP、PNG、WEBP。\n图片分辨率：分辨率要求大于32×32像素，无上限要求，但是太大可能会下载超时。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Score": { "type": "number", "description": "图像构图美学评分，取值0~5。评分越高，构图效果越好，推荐评分3.8以上为较好构图得分。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_17_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "输入图片URL地址" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2585-16": { "x-pointCode": 16, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图片上色", "description": "图片上色可以对黑白照片、黑白图像自动上色。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、BMP、PNG。\n图像分辨率：分辨率小于4000×4000像素。\n图像大小：图像大小不超过10M。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageUrl": { "type": "string", "description": "台标标志擦除后的结果图像URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_16_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "ImageURL": { "type": "string", "description": "图片URL地址。" } }, "required": [ "ds_id", "ImageURL" ] } } } } } }, "/2585-15": { "x-pointCode": 15, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像人体擦除", "description": "图像人体擦除可以擦除图像中指定区域的人像，并自动填充背景。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、BMP、PNG、WEBP、TIF。\n图像大小：图像大小不超过3M。\n图像分辨率：图片分辨率要求大于5×5像素，小于2048×2048像素。\n图片中指定区域应尽量贴合人形，可以用矩形、多边形、不规则区域表示。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageUrl": { "type": "string", "description": "台标标志擦除后的结果图像URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_15_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "ImageURL": { "type": "string", "description": "图片URL地址。" }, "UserMask": { "type": "string", "description": "图像对于Mask的URL地址。" } }, "required": [ "ds_id", "ImageURL", "UserMask" ] } } } } } }, "/2585-14": { "x-pointCode": 14, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像隐形文字水印", "description": "可以为图片添加或者解析指定文字水印。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：PNG、JPG、BMP。\nURL中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "WatermarkImageURL": { "type": "string", "description": "添加了水印的图片URL地址。" }, "LogoURL": { "type": "string", "description": "解码后的水印图URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_14_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "Text": { "type": "string", "description": "待加入的水印文字。调用功能为encode_text时有效。" }, "FunctionType": { "type": "string", "description": "指定调用功能。包括\n\nencode_text：添加指定文字水印\ndecode_text：解析指定文字水印" }, "OriginImageURL": { "type": "string", "description": "当调用功能为encode_text时，该参数值为待合成的无水印图。\n当调用功能为decode_text时，该参数值为无文字水印的原图。" }, "OutputFileType": { "type": "string", "description": "输出图格式。可以选择PNG、JPG、BMP。" }, "QualityFactor": { "type": "string", "description": "输出格式为JPG时，可以设置输出图像的大小，图像越大质量越高。取值范围1~100。" }, "WatermarkImageURL": { "type": "string", "description": "带有文字水印的图。调用功能为decode_text时有效。" } }, "required": [ "ds_id", "Text", "FunctionType", "OriginImageURL", "OutputFileType", "QualityFactor" ] } } } } } }, "/2585-13": { "x-pointCode": 13, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像隐形图片水印", "description": "可以为图像添加或解析图片水印。\n例如您有一张图A，调用encode_pic参数添加图片盲水印后得到图B。或者您也可以将图A作为OriginImageURL，将图B作为WatermarkImageURL输入，调用decode_pic参数就可以解析得到水印图片。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：PNG、JPG、BMP。\nURL中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "WatermarkImageURL": { "type": "string", "description": "添加了水印的图片URL地址。" }, "LogoURL": { "type": "string", "description": "解码后的水印图URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_13_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "FunctionType": { "type": "string", "description": "指定调用功能。包括：\n\nencode_pic：为采用老版本模型添加图像水印。\nencode_pic_plus：为采用新版本模型添加图像水印。\ndecode_pic：为采用老版本模型解码图像中的图像水印，对应加水印方法encode_pic。\ndecode_pic_plus：为采用新版本模型解码图像中的图像水印，对应加水印方法encode_pic_plus。" }, "LogoURL": { "type": "string", "description": "待添加的水印图片URL。\n说明\n当FunctionType为encode_pic或encode_pic_plus时，该参数必填。\n当FunctionType为decode_pic或decode_pic_plus时，该参数不填。" }, "WatermarkImageURL": { "type": "string", "description": "待解析图，即带有图片水印的合成图\n说明\n当FunctionType为decode_pic或decode_pic_plus时，该参数必填。\n当FunctionType为encode_pic或encode_pic_plus时，该参数不填。" }, "OutputFileType": { "type": "string", "description": "输出图格式。可以选择jpeg、png、jpg、bmp四种格式，默认png。\n\n说明\n当FunctionType为encode_pic或encode_pic_plus时，该参数必填。\n当FunctionType为decode_pic或decode_pic_plus时，该参数不填。" }, "QualityFactor": { "type": "string", "description": "输出图像的质量大小。图像越大质量越高，取值范围1~100，默认100。\n\n说明仅当OutputFileType为jpg时有效。" }, "OriginImageURL": { "type": "string", "description": "原图。\n说明\n当FunctionType为encode_pic、encode_pic_plus或decode_pic时，该参数必填。\n当FunctionType为decode_pic_plus时，该参数不填。" } }, "required": [ "ds_id", "FunctionType" ] } } } } } }, "/2585-12": { "x-pointCode": 12, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "台标标志擦除", "description": "用于擦除图片中的常见标志，如台标、互联网平台logo标志等。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、PNG。\nURL地址不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "台标标志擦除后的结果图像URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_12_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "ImageURL": { "type": "string", "description": "图片URL地址。" } }, "required": [ "ds_id", "ImageURL" ] } } } } } }, "/2585-11": { "x-pointCode": 11, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "字幕擦除", "description": "可以擦除图片中的标准字幕。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、PNG。\nURL地址不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "输出擦除字幕后的图像URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_11_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "ImageURL": { "type": "string", "description": "图片URL地址。" }, "BX": { "type": "string", "description": "字幕区域的左上角点x坐标相对视频宽度的占比值，取值范围0~1。" }, "BY": { "type": "string", "description": "字幕区域的左上角点y坐标相对视频高度的占比值，取值范围0~1。" }, "BW": { "type": "string", "description": "字幕区域的宽度相对视频宽度的占比值，取值范围0~1。" }, "BH": { "type": "string", "description": "字幕区域的高度相对视频高度的占比值，取值范围0~1。" } }, "required": [ "ds_id", "ImageURL" ] } } } } } }, "/2585-10": { "x-pointCode": 10, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "照图修图", "description": "可以将输入的参考图的光照、色彩等不影响原图结构的风格迁移至目标图。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、PNG。\n图片分辨率：分辨率要求大于32×32像素，小于3000×3000像素。\nURL地址不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "进行风格变换后的结果图片URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_10_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "StyleUrl": { "type": "string", "description": "参考图URL地址" }, "ImageURL": { "type": "string", "description": "图片URL地址。" } }, "required": [ "ds_id", "StyleUrl", "ImageURL" ] } } } } } }, "/2585-9": { "x-pointCode": 9, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "智能构图", "description": "通过对输入图像进行美学评估，智能输出bounding box，根据这些bounding box可以将原图裁剪成更好的图像。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n请求格式：JPEG、JPG、PNG、BMP、WEBP。\n图像大小：无限制，但图像太大可能会导致下载或解码超时。\n图像分辨率：图片分辨率要求32×32像素以上。\n图片URL中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Elements": { "type": "array", "items": { "type": "object", "properties": { "MinY": { "type": "number", "description": "输出框的左上角纵坐标。" }, "MinX": { "type": "number", "description": "输出框的左上角横坐标。" }, "Score": { "type": "number", "description": "输出框的评分，取值范围0~5。分数越高说明构图效果越好，推荐3.8以上为较好构图得分。" }, "MaxY": { "type": "number", "description": "输出框的右下角纵坐标。" }, "MaxX": { "type": "number", "description": "输出框的右下角横坐标。" } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_9_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ds_id": { "type": "string" }, "NumBoxes": { "type": "string", "description": "输出框的个数，默认值5，取值范围1~10，小于或超出范围会截断取值。" }, "ImageURL": { "type": "string", "description": "图片URL地址。" } }, "required": [ "ds_id", "NumBoxes", "ImageURL" ] } } } } } }, "/2585-8": { "x-pointCode": 8, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像裁剪", "description": "阿里原接口订购地址：https://vision.aliyun.com/imageenhan", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "RetainLocation": { "type": "object", "properties": { "Height": { "type": "number", "description": "输出根据指定高度等比缩放后的原图高度。单位：像素。" }, "Width": { "type": "number", "description": "输出根据指定宽度等比缩放后的原图宽度。单位：像素。" }, "Y": { "type": "number", "description": "原图左上角y坐标。" }, "X": { "type": "number", "description": "原图左上角x坐标。" } }, "description": "原图数据在生成图像中的坐标信息。" }, "Url": { "type": "string", "description": "尺寸变换后的图片URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_8_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "Height": { "type": "string", "description": "目标高度，单位：像素。" }, "Width": { "type": "string", "description": "目标宽度，单位：像素。" }, "Url": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "Height", "Width", "Url", "ds_id" ] } } } } } }, "/2585-7": { "x-pointCode": 7, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像微动", "description": "可以对输入图像中包括的天空区域及人物头发区域进行静转动处理，得到微动的AVI格式视频。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、JPEG、BMP、PNG。\n图片大小：大小不超过3M。\n图片分辨率：分辨率要求大于32×32像素，小于2000×2000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Url": { "type": "string", "description": "微动变换后的视频URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_7_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "Url": { "type": "string", "description": "图片URL地址" }, "ds_id": { "type": "string" }, "Operation": { "type": "string", "description": "天空和头发的微动状态。采用二进制字符串，某一位为1表示对应区域进行微动。\n\n最低位为1，表示天空微动；第二位为1，表示头发微动。\n\n1和01均表示天空微动。\n10表示头发微动，天空不动。\n11表示头发和天空都微动。" } }, "required": [ "Url", "ds_id", "Operation" ] } } } } } }, "/2585-6": { "x-pointCode": 6, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像色彩增强", "description": "可以对输入图片的饱和度、亮度以及肤色等进行最优调整。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、PNG、BMP。\n图片分辨率：大于64×64像素，小于3840×3840像素。不符合时系统会自动对图片进行缩放。\nURL地址不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "返回处理后的图片URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_6_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址" }, "ds_id": { "type": "string" }, "Mode": { "type": "string", "description": "调色模式。包括LogC和Rec709。" }, "OutputFormat": { "type": "string", "description": "输出的图片格式。可选png和jpg。" } }, "required": [ "ImageURL", "ds_id", "Mode", "OutputFormat" ] } } } } } }, "/2585-5": { "x-pointCode": 5, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "查询异步任务结果", "description": "异步接口调用API接口后，返回的并不是真正的请求结果，您需要保存返回结果中的RequestId，然后调用本接口来获取真正的请求结果。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Result": { "type": "string", "description": "异步任务返回的真实请求结果。" }, "Status": { "type": "string", "description": "异步任务状态。包括：\n\nQUEUING：任务排队中\nPROCESSING：异步处理中\nPROCESS_SUCCESS：处理成功\nPROCESS_FAILED：处理失败\nTIMEOUT_FAILED：任务超时未处理完成\nLIMIT_RETRY_FAILED：超过最大重试次数" }, "JobId": { "type": "string", "description": "异步任务Id。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_5_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "JobId": { "type": "string", "description": "异步接口返回的RequestId，输入后可以查询异步接口的真实请求结果。" }, "ds_id": { "type": "string" } }, "required": [ "JobId", "ds_id" ] } } } } } }, "/2585-4": { "x-pointCode": 4, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "高清色彩迁移", "description": "用于对高清图像进行颜色拓色，并能够保证人像部分颜色不发生变化。该接口与色彩迁移相比：\n支持高清图。\n支持自定义拓色程度。\n支持人像色彩保持。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：PNG、JPG、JPEG。\n图片分辨率：分辨率要求小于10000×10000像素。\n图像必须是RGB 3通道。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string", "description": "任务id，需要调用查询异步任务查看结果" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_4_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "Degree": { "type": "string", "description": "拓色程度。取值范围0~1。" }, "ds_id": { "type": "string" }, "Mode": { "type": "string", "description": "拓色模式。包括：\n\nAUTO：自动拓色。\nTEMPLATE：色板拓色。\nREF_PIC：参考图拓色。" }, "Url": { "type": "string", "description": "待拓色的图片URL地址。" }, "RefUrl": { "type": "string", "description": "拓色时参考图片的URL地址。" }, "ColorCount": { "type": "string", "description": "拓展色系数量，取值范围1~3。" }, "Color1": { "type": "string", "description": "Top主色列表，颜色值定义RGB" }, "Color2": { "type": "string", "description": "Top主色列表，颜色值定义RGB" }, "Color3": { "type": "string", "description": "Top主色列表，颜色值定义RGB" } }, "required": [ "Degree", "ds_id", "Mode", "Url" ] } } } } } }, "/2585-3": { "x-pointCode": 3, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "图像超分", "description": "可以将输入图放大四倍，同时基于推断出的细节保持结果图像的清晰度。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、PNG。\n图片大小：长度小于1500像素，或长×宽小于700,000像素，且大小不超过9.5MB。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Url": { "type": "string", "description": "分辨率放大后的图片URL地址，图片格式为PNG。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_3_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "Url": { "type": "string", "description": "图片URL地址" }, "ds_id": { "type": "string" } }, "required": [ "Url", "ds_id" ] } } } } } }, "/2585-2": { "x-pointCode": 2, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "色彩迁移", "description": "将输入图自动或根据指定色板进行色彩转换，同时避免视觉热点区域不正常拓色。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPG、PNG。\n图片大小：大小不超过1.6 MB。\n图片分辨率：分辨率要求小于1200×1200像素。\n图像都必须是RGB 3通道或者RGBA 4通道。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageList": { "type": "array", "items": { "type": "string" }, "description": "拓色完成后的图片URL地址，图片格式为PNG。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_2_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "Mode": { "type": "string", "description": "拓色模式。默认为AUTO。\n\nAUTO：自动拓色\nTEMPLATE：色板拓色\nREF_PIC：参考图拓色" }, "Url": { "type": "string", "description": "图片URL地址" }, "ds_id": { "type": "string" }, "RefUrl": { "type": "string", "description": "参考图拓色。参考图的URL地址。" }, "ColorCount": { "type": "string", "description": "拓展色系数量，取值范围1~3，默认为1。" }, "Color1": { "type": "string", "description": "色板拓色，Top主色" }, "Color2": { "type": "string", "description": "色板拓色" }, "Color3": { "type": "string", "description": "色板拓色" } }, "required": [ "Mode", "Url", "ds_id" ] } } } } } }, "/2585-1": { "x-pointCode": 1, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "风格迁移", "description": "可以对输入图像的风格进行转换，使得图像的色彩、笔触等视觉风格发生转化。阿里原接口订购地址：https://vision.aliyun.com/imageenhan\n\n输入限制\n图片格式：JPEG、JPG、BMP、PNG。\n图片大小：大小不超过3MB。\n图片分辨率：分辨率要求小于1200×1200像素。\n图像都必须是RGB 3通道。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Url": { "type": "string", "description": "进行风格化的结果图片URL地址，图片格式：PNG。" }, "MajorUrl": { "type": "string", "description": "保留人像不变，其余部分风格化的结果。如果输入的majorUrl内容图中无人物，则这里返回空字符串。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2585_1_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "MajorUrl": { "type": "string", "description": "内容图片URL地址，图片最大边分辨率不能超过1000" }, "StyleUrl": { "type": "string", "description": "风格图片URL地址，图片最大边分辨率不能超过1000" }, "ds_id": { "type": "string" } }, "required": [ "MajorUrl", "StyleUrl", "ds_id" ] } } } } } } }, "components": { "securitySchemes": { "AppKeyAuth": { "type": "apiKey", "in": "query", "name": "appKey", "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp" } }, "schemas": { "ShowapiResEnvelope": { "type": "object", "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）", "properties": { "showapi_res_code": { "type": "integer", "description": "API 返回的状态码" }, "showapi_res_error": { "type": "string", "description": "API 返回的错误信息" }, "showapi_res_id": { "type": "string", "description": "API 请求的唯一标识" }, "showapi_fee_num": { "type": "integer", "description": "API 调用计费次数" } } } } }, "security": [ { "AppKeyAuth": [] } ], "externalDocs": { "url": "https://www.showapi.com/apiGateway/view/2585?tab=book" }, "x-apiCode": "2585", "x-is-own": false, "x-is-op": true }