# Generated by ShowAPI OpenAPI generator # source: market/2586 # generated-at: 2026-09-20T22:17:41.231Z 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: /2586-19: x-pointCode: 19 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 高清人体分割 description: |- 高清人体分割可以识别输入图像中的人体轮廓，与背景进行分离，返回分割后的前景人像图。阿里原接口订购地址：https://vision.aliyun.com/imageseg 输入限制 图像格式：JPG、JPEG 、BMP、PNG（透明图）。 图像大小：不超过50M。 图像分辨率：大于32×32像素，小于10000×10000像素。 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: ImageURL: type: string description: 结果图像的URL地址。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_19_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 /2586-18: x-pointCode: 18 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 天空替换 description: |- 输入两种图像，ChangeSky可以将参考图B的天空样式替换到目标图A中，从而改变目标图A的天空样式，实现换天功能。阿里原接口订购地址：https://vision.aliyun.com/imageseg 输入限制： 图片格式：PNG、JPEG、JPG、BMP。 图片大小：大小不超过9M。 图片分辨率：分辨率要求大于50×50像素，小于3000×3000像素。 URL地址中不能包含中文字符。 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: ImageURL: type: string description: 结果图像URL地址，有效期30分钟。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_18_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: ds_id: type: string ImageURL: type: string description: 图片URL地址。 ReplaceImageURL: type: string description: |- 参考图URL地址 false：同步获取结果。 true：异步获取结果。提交请求后，需要调用GetAsyncJobResult接口获取结果。 required: - ds_id - ImageURL /2586-17: x-pointCode: 17 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: Mask精细化分割 description: |- 用于对输入图像与粗糙mask进行精细化处理，输出精细化mask。阿里原接口订购地址：https://vision.aliyun.com/imageseg 输入限制 图像格式：JPG、JPEG、BMP、PNG。 图像大小：图像大小需要小于3M。 图像分辨率：大于32×32像素，小于2000×2000像素。 图片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: ImageURL: type: string description: 输出的精细化mask的图像URL地址。 description: 返回结果的图像。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_17_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: ds_id: type: string ImageURL: type: string description: 图片URL地址。 MaskImageURL: type: string description: 与输入图像对应的粗糙mask图像。 required: - ds_id - ImageURL - MaskImageURL /2586-16: x-pointCode: 16 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 室外场景分割 description: |- 可以对图像中的场景进行像素级抠图。当前共支持13种场景：天空、草地、地面、树木、花、山石、水、雪地、建筑物、人物、动物、交通工具、结构物、其他。阿里原接口订购地址：https://vision.aliyun.com/imageseg 输入限制 图片格式：PNG、JPEG、JPG、BMP。 图片分辨率：分辨率要求大于50×50像素，小于3000×3000像素。 图片大小：大小不超过9.5M。 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: ImageURL: type: string description: 结果图像的URL地址。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_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 /2586-14: x-pointCode: 14 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 天空分割 description: |- 可以识别输入图像中的天空区域，与背景进行分离，返回分割后的前景区域图。阿里原接口订购地址：https://vision.aliyun.com/imageseg 输入限制 图片格式：JPG、JPEG 、BMP、PNG。 图片大小： 图片大小不超过9.5M。 图片分辨率：大于50×50像素，小于3000×3000像素。 图片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: ImageURL: type: string description: 结果图像的URL地址。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_14_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 /2586-13: x-pointCode: 13 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 食品分割 description: |- 用于对图片中的食品进行像素级抠图，并返回抠图结果。阿里原接口订购地址：https://vision.aliyun.com/imageseg 输入限制 图片类型：PNG、JPEG、JPG、BMP。 图片大小：大小不超过4 M。 图片分辨率：大于40×40像素，小于1999×1999像素。 图片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: ImageURL: type: string description: 结果图像的URL地址。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_13_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 /2586-10: x-pointCode: 10 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 通用分割 description: |- 可以识别输入图像中视觉中心的物体轮廓，将物体与背景进行分离，返回分割后的前景物体图（4通道）。阿里原接口订购地址：https://vision.aliyun.com/imageseg 输入限制 图片格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。 图像大小：图像大小不超过3M。 图像分辨率：分辨率要求大于32×32像素，小于1280×1280像素。 图片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: ImageURL: type: string description: 结果图像URL地址，有效期30分钟。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_10_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 /2586-9: x-pointCode: 9 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 商品分割 description: |- 商品分割用于识别输入图像中的商品轮廓，与背景进行分离，返回分割后的前景商品图（4通道），适用于单商品、多商品、复杂背景等场景。 输入限制 图片格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。 图像大小：图像大小不超过3M。 图像分辨率：小于1280×1280像素。 图片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: ImageURL: type: string description: 结果图像URL地址，有效期半个小时。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_9_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 /2586-8: x-pointCode: 8 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 服饰分割 description: |- 可以对输入图像中的服饰进行像素级抠图，并返回抠图结果。 输入限制 图片类型：PNG、JPEG、JPG、BMP。 图片大小：图片大小不超过3M。 图片分辨率：大于50×50像素，且小于3000×3000像素。 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: ImageURL: type: string description: 返回抠图结果图片URL地址。 description: 返回元素的数组。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_8_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 /2586-7: x-pointCode: 7 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 家具分割 description: |- 以对输入图片中的家具进行像素级抠图。 输入限制 图像类型：PNG、JPEG、JPG、BMP。 图像大小：输入图像大小不超过4M。 图像分辨率：分辨率要求大于40×40像素，小于1999×1999像素。 图片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: ImageURL: type: string description: 家具分割后的结果图URL地址。 description: 家具抠图结果。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_7_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 /2586-6: x-pointCode: 6 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 皮肤分割 description: |- 用于识别图片中的人物皮肤，并对图中人物的皮肤区域进行分割，输出对应的mask图。 输入限制： 图片格式：PNG（不支持8位、16位、64位PNG）、JPEG、JPG、BMP。 图片大小：大小不超过3M。 图片分辨率：分辨率要求大于32×32像素，小于2000×2000像素。 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: URL: type: string description: 分割结果图片的URL地址。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_6_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: ds_id: type: string URL: type: string description: 图片URL地址。 required: - ds_id - URL /2586-5: x-pointCode: 5 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 五官分割 description: |- 可以检测输入的人脸正面图像，对眼睛、鼻子、嘴进行像素级语义分割。 输入限制 图片格式：JPG、JPEG 、PNG。 图片分辨率：分辨率要求大于100×100，小于2048×2048，且宽高比在0.5~2.0之间。 图片大小：大小不超过4M。 图片中仅包含单个人脸，要求正面，无眼镜、帽子等遮挡物。人脸部分的面积大小至少在100×100，且人脸检测框至少是对应边长的1/10。 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: OriginImageURL: type: string description: 原始图片URL地址。 Elements: type: array items: type: object properties: Name: type: string description: 抠图结果key值。具体请参见下面表格说明。 ImageURL: type: string description: 抠图结果，有效期半个小时。 description: 各个子元素的分割结果。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_5_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 /2586-4: x-pointCode: 4 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 头发分割 description: |- 用于识别图片中的人物头像，然后对人物头像区域进行抠图解析，最后输出PNG格式的人物头发透明图。 输入限制 图片格式：JPEG、JPG、PNG、BMP。 图像大小：图像大小不超过3M。 图像分辨率：分辨率要求大于32×32像素，小于2000×2000像素。 图片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: ImageURL: type: string description: 结果图像URL地址，有效期30分钟。 Height: type: number description: 结果图的高度。 Width: type: number description: 结果图的宽度。 Y: type: number description: 左上角y坐标。 X: type: number description: 左上角x坐标。 description: 各个子元素的抠图结果。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_4_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 /2586-2: x-pointCode: 2 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 头像分割 description: |- 头像分割用于识别图片中的人物头像，并对人物头像进行抠图解析，最后输出PNG格式的人物头像透明图。 输入限制 图片格式：JPEG、JPG、PNG、BMP。 图像大小：图像大小不超过3M。 图像分辨率：分辨率要求大于32×32像素，小于2000×2000像素。 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: ImageURL: type: string description: 结果图像URL地址，有效期30分钟。 Height: type: number description: 结果图的高度。 Width: type: number description: 结果图的宽度。 Y: type: number description: 左上角y坐标。 X: type: number description: 左上角x坐标。 description: 各个子元素的抠图结果。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_2_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: ds_id: type: string ImageURL: type: string description: 图片URL地址。 ReturnForm: type: string description: |- 指定返回的图像形式。 如果设置为mask，则返回单通道mask。 如果不设置或者设置为任意非mask值，则返回四通道png图。 required: - ds_id - ImageURL /2586-1: x-pointCode: 1 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 人体分割 description: |- 人体分割用于识别输入图像中的人体轮廓，与背景进行分离，返回分割后的前景人像图（4通道），适用于单人、多人、复杂背景、各类人体姿态等场景。 输入限制 图片格式：JPEG、JPG、PNG（不支持8位、16位、64位PNG）、BMP、WEBP。 图像大小：输入图像大小不超过3M。 图像分辨率：分辨率要求小于1280×1280像素。 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: ImageURL: type: string description: 结果图像URL地址，有效期30分钟。 ret_code: type: number remark: type: string RequestId: type: string description: 业务返回体 operationId: 2586_1_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: ds_id: type: string ImageURL: type: string description: 图片URL地址。 ReturnForm: type: string description: |- 指定返回的图像形式。 如果设置为mask，则返回单通道mask。 如果不设置或者设置为任意非mask值，则返回四通道png图。 required: - ds_id - ImageURL 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/2586?tab=book x-apiCode: "2586" x-is-own: false x-is-op: false