# Generated by ShowAPI OpenAPI generator
# source: market/2586
# generated-at: 2026-06-26T06:26:20.966Z
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: true
