# Generated by ShowAPI OpenAPI generator
# source: market/2584
# generated-at: 2026-06-26T01:54:34.009Z
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:
  /2584-11:
    x-pointCode: 11
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 菜品识别
      description: |-
        证件照质量审核可以识别拍摄的证件照片是否存在质量问题，且有哪些质量问题。
        阿里原接口订购地址：https://vision.aliyun.com/imagerecog
        输入限制
        图像类型：JPEG、JPG、BMP、PNG。
        图像大小：小于10M。
        图像分辨率：大于100×100像素，小于5000×5000像素。
        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:
                              Threshold:
                                type: number
                                description: 输出汽车类型的最大概率值。
                              Elements:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Name:
                                      type: string
                                      description: 汽车车型名称。
                                    Score:
                                      type: number
                                      description: 汽车车型名称的置信度。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_11_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
  /2584-10:
    x-pointCode: 10
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 证件照质量审核
      description: |-
        证件照质量审核可以识别拍摄的证件照片是否存在质量问题，且有哪些质量问题。阿里原接口订购地址：https://vision.aliyun.com/imagerecog

        输入限制
        图像类型：JPEG、JPG、BMP、PNG。
        图像大小：小于10M。
        图像分辨率：大于100×100像素，小于5000×5000像素。
        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:
                              Threshold:
                                type: number
                                description: 输出汽车类型的最大概率值。
                              Elements:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Name:
                                      type: string
                                      description: 汽车车型名称。
                                    Score:
                                      type: number
                                      description: 汽车车型名称的置信度。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_10_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ImageURL:
                  type: string
                  description: 图片URL地址。
                Type:
                  type: string
                  description: |-
                    证照类型。

                    IDCard：身份证。
                    BusinessLicense：电子执照。
                ds_id:
                  type: string
              required:
                - ImageURL
                - Type
                - ds_id
  /2584-9:
    x-pointCode: 9
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 场景识别
      description: |-
        阿里原接口订购地址：https://vision.aliyun.com/imagerecog。可以识别图像中的场景环境，支持数十种常见场景，包括：人物、会议室、公路、其他、办公室、动物、卧室、商场、地铁、夜景、天空、婚礼、室内、室外、小河、山峰、广场、建筑、户外、手机、旅行、日出、日落、显示器、树林、植物、水果、汽车、沙滩、沙漠、海滨、游乐场、湖、演出、火车、烧烤、物品、 狗、猫、美食、聚餐、自行车、船、花、草地、蔬菜、街景、街道、运动、运动场、露营、飞机、餐厅、鱼、鸟。

        输入限制
        请求格式：JPEG、JPG、PNG、BMP。
        图像大小：图像大小不超过3M。
        图像分辨率：图片要求5×5像素以上。
        图片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:
                              Tags:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Confidence:
                                      type: number
                                      description: 标签名称的置信度。取值范围0~100。
                                    Value:
                                      type: string
                                      description: 标签名称。
                                description: |-
                                  标签名称。最多输出5个标签名称，如果某个类别标签未输出，则对应的confidence为零。每个标签会输出confidence和value两个参数：

                                  value：标签名称。
                                  confidence：标签名称置信度。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_9_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ImageURL:
                  type: string
                ds_id:
                  type: string
              required:
                - ImageURL
                - ds_id
  /2584-6:
    x-pointCode: 6
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 垃圾分类识别
      description: |-
        可以对图片中的物品垃圾进行分类，并给出具体的物品名称。阿里原接口订购地址：https://vision.aliyun.com/imagerecog

        输入限制
        图片类型：JPEG、JPG、PNG。
        图片大小：图片小于等于3M。
        图片分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。
        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:
                              Sensitive:
                                type: boolean
                                description: |-
                                  图片中是否存在敏感信息。

                                  true：存在敏感信息，不会返回具体垃圾分类信息。
                                  false：不存在敏感信息。
                              Elements:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    RubbishScore:
                                      type: number
                                      description: 物品名称的置信度。
                                    Category:
                                      type: string
                                      description: 垃圾类别。包括可回收垃圾、干垃圾、湿垃圾、有害垃圾。
                                    CategoryScore:
                                      type: number
                                      description: 识别出的垃圾类别的置信度。
                                    Rubbish:
                                      type: string
                                      description: 具体的物品名称。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_6_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
  /2584-5:
    x-pointCode: 5
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 风格识别
      description: |-
        阿里原接口订购地址：https://vision.aliyun.com/imagerecog。
        可以对输入图像的风格类型进行分析，识别可能的风格与语意标签。可以识别的风格包括：chinese（中国风）、watercolor（水彩）、cartoon（卡通）、real（实景）、standard（标准）、simple（简洁）、lively（活泼）、colourful（多彩）、luxury（豪华）、technology（科技）、morbidezza（柔美）、strong（硬朗）、simpleelegant（素雅）、coolcold（高冷）、promotion（促销）、protrude（突出）。

        输入限制
        图片格式：PNG、JPG、JPEG、BMP、WEBP。
        图片大小：大小不超过9.5 MB。
        图片分辨率：小于3000×3000像素。
        图像都必须是RGB 3通道。
        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:
                              Styles:
                                type: array
                                items:
                                  type: string
                                description: 识别出的风格列表。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_5_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
  /2584-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 元素识别
      description: |-
        用于识别输入图像中所包含的元素内容，用矩形框标注出其位置，并区分其对应的基本类型（人物、修饰、文案）。阿里原接口订购地址：https://vision.aliyun.com/imagerecog

        输入限制
        图片格式：JPG、JPEG、BMP、PNG。
        图片大小：大小不超过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:
                              Elements:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Type:
                                      type: string
                                      description: |-
                                        元素类型。包括：

                                        UnType（未定义类型）、AllType（所有类型）、RootType（跟类型）、Synthesis（组合元素图）、Embedded（所有嵌套类型）、Format（元素格式）、MajorObject（主体）、Character（文案）、Identifier（标识）、Background（背景）、Decoration（修饰）、MajorHuman（人物模特）、MajorAuction（商品）、MajorThing（物体）、MajorOther（其他主体）、CharMain（主文案）、CharSub（副文案）、CharAction（行动点文案）、CharContent（内容文案）、CharNumber（数字文案）、CharOther（其他文案）、IdentLogo（logo标识）、IdentLight（高亮标识）、IdentCode（码标识）、IdentOther（其他标识）、BackBitmap（位图背景）、BackVector（矢量图背景）、BackOther（其他背景）、DecoTile（平铺修饰）、DecoRegion（区域修饰）、DecoPieces（碎片修饰）、DecoEdge（贴边修饰）、DecoLine（线性修饰）、DecoBox（框型修饰）、DecoChar（行动点文案修饰）、DecoOther（其他修饰）、SynthMajor（主体组团）、SynthChar（文案组团）、SynthIdent（标识组团）、SynthBack（背景组团）、SynthDeco（修饰组团）、SynthOther（其他组团）、EmbedSvg（svg嵌套格式）、EmbedJson（JSON嵌套格式）、EmbedHtml（html嵌套格式）。
                                    Height:
                                      type: number
                                      description: 元素高度。
                                    Width:
                                      type: number
                                      description: 元素宽度。
                                    Y:
                                      type: number
                                      description: 元素左上角y坐标。
                                    Score:
                                      type: number
                                      description: 预测分值[0.0, 1.0]。
                                    X:
                                      type: number
                                      description: 元素左上角x坐标。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_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
  /2584-2:
    x-pointCode: 2
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 颜色识别
      description: |-
        可以对输入图片的颜色信息进行分析，输出颜色值（RGB形式和HEX格式）与对应的占比信息。阿里原接口订购地址：https://vision.aliyun.com/imagerecog

        图片限制
        图片格式：PNG、JPG、JPEG、BMP。
        图片大小：大小不超过9.5 MB。
        图片分辨率：小于2500×2500像素。
        图像都必须是RGB 3通道。
        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:
                              ColorTemplateList:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Percentage:
                                      type: string
                                      description: 当前颜色标签所占比例，取值范围[0.0, 1.0]。
                                    Label:
                                      type: string
                                      description: 颜色标签，共11种：black、white、gray、red、orange、yellow、green、cyan、blue、purple、magenta。
                                    Color:
                                      type: string
                                      description: RGB颜色值（16进制），例如：291A18。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_2_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                Url:
                  type: string
                  description: 图片URL地址。
                ds_id:
                  type: string
                ColorCount:
                  type: string
                  description: 期望的色板输出数量。取值范围1~10，默认值为3。
              required:
                - Url
                - ds_id
                - ColorCount
  /2584-1:
    x-pointCode: 1
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 通用图像打标
      description: |-
        于识别图像中的主体内容并打上类型标签，支持数千个内容标签，覆盖常见物体品类。阿里原接口订购地址：https://vision.aliyun.com/imagerecog

        输入限制
        图片格式：JPEG、JPG、PNG、BMP。
        图像大小：图像大小不超过3M。
        图像分辨率：分辨率要求5×5像素以上。
        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:
                              Tags:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Confidence:
                                      type: number
                                      description: 标签名称对应的置信度，取值范围0~100。
                                    Value:
                                      type: string
                                      description: 标签名称。
                                description: |-
                                  输出打标结果，最多输出5个打标结果，如果某个类别标签未输出，则对应的置信度confidence为零。每个标签会输出confidence和value两个参数：

                                  value：标签名称。
                                  confidence：标签名称对应的置信度。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2584_1_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
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/2584?tab=book
x-apiCode: "2584"
x-is-own: false
x-is-op: true
