# Generated by ShowAPI OpenAPI generator
# source: market/2582
# generated-at: 2026-06-25T21:14:21.871Z
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:
  /2582-24:
    x-pointCode: 24
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 火车票识别
      description: |-
        可以对火车票进行结构化识别，输出乘车时间、始发站、目的站、座位席别、乘车人姓名、车次号、票价、车厢及座次号，共8个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr

        输入限制
        图片格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              Name:
                                type: string
                                description: 乘车人姓名。
                              Date:
                                type: string
                                description: 乘车日期时间。
                              Seat:
                                type: string
                                description: 座位车厢及座次号。
                              Number:
                                type: string
                                description: 车次号。
                              Price:
                                type: number
                                description: 票价。
                              DepartureStation:
                                type: string
                                description: 始发站点。
                              Level:
                                type: string
                                description: 座位席别。
                              Destination:
                                type: string
                                description: 目的站点。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_24_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
  /2582-22:
    x-pointCode: 22
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 增值税发票识别
      description: |-
        可以识别增值税发票（电子发票和纸质发票）关键字段内容，包括：校验码、复核人、开票人、发票代码、收款人等。阿里原接口订购地址：https://vision.aliyun.com/ocr

        输入限制
        图片格式：PDF、JPG。
        图片大小：大小不超过10M。
        图片分辨率：不限制图片分辨率，但图片分辨率太高可能会导致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:
                              Box:
                                type: object
                                properties:
                                  PayeeNames:
                                    type: array
                                    items:
                                      type: number
                                    description: 销售方名称位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  PayeeAddresses:
                                    type: array
                                    items:
                                      type: number
                                    description: 销售方地址及电话位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  InvoiceNoes:
                                    type: array
                                    items:
                                      type: number
                                    description: 发票号码位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  Clerks:
                                    type: array
                                    items:
                                      type: number
                                    description: 开票人位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  PayeeBankNames:
                                    type: array
                                    items:
                                      type: number
                                    description: 销售方开户行及账号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  PayerRegisterNoes:
                                    type: array
                                    items:
                                      type: number
                                    description: 购买方纳税人识别号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  InvoiceFakeCodes:
                                    type: array
                                    items:
                                      type: number
                                    description: 校验码位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  InvoiceCodes:
                                    type: array
                                    items:
                                      type: number
                                    description: 发票代码位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  PayerNames:
                                    type: array
                                    items:
                                      type: number
                                    description: 购买方名称位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  PayerAddresses:
                                    type: array
                                    items:
                                      type: number
                                    description: 购买方地址及电话位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  PayerBankNames:
                                    type: array
                                    items:
                                      type: number
                                    description: 购买方开户行及账号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  Payees:
                                    type: array
                                    items:
                                      type: number
                                    description: 收款人位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  SumAmounts:
                                    type: array
                                    items:
                                      type: number
                                    description: 价税合计位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  TaxAmounts:
                                    type: array
                                    items:
                                      type: number
                                    description: 合计税额位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  InvoiceAmounts:
                                    type: array
                                    items:
                                      type: number
                                    description: 价税合计位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  InvoiceDates:
                                    type: array
                                    items:
                                      type: number
                                    description: 开票日期位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  WithoutTaxAmounts:
                                    type: array
                                    items:
                                      type: number
                                    description: 合计金额位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  PayeeRegisterNoes:
                                    type: array
                                    items:
                                      type: number
                                    description: 销售方纳税人识别号位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                                  Checkers:
                                    type: array
                                    items:
                                      type: number
                                    description: 复核人位置框信息，格式为【左上角点x坐标，左上角点y坐标，右上角点x坐标，右上角点y坐标】。
                              Content:
                                type: object
                                properties:
                                  PayeeBankName:
                                    type: string
                                    description: 销售方开户行及账号。
                                  Payee:
                                    type: string
                                    description: 收款人。
                                  Checker:
                                    type: string
                                    description: 复核人。
                                  InvoiceDate:
                                    type: string
                                    description: 开票日期。
                                  PayerBankName:
                                    type: string
                                    description: 购买方开户行及账号。
                                  Clerk:
                                    type: string
                                    description: 开票人。
                                  WithoutTaxAmount:
                                    type: string
                                    description: 合计金额。
                                  PayeeRegisterNo:
                                    type: string
                                    description: 销售方纳税人识别号。
                                  SumAmount:
                                    type: string
                                    description: 价税合计（大写）。
                                  TaxAmount:
                                    type: string
                                    description: 合计税额。
                                  AntiFakeCode:
                                    type: string
                                    description: 校验码。
                                  PayerName:
                                    type: string
                                    description: 购买方名称。
                                  InvoiceCode:
                                    type: string
                                    description: 发票代码。
                                  InvoiceAmount:
                                    type: string
                                    description: 价税合计（小写）。
                                  PayerAddress:
                                    type: string
                                    description: 购买方地址、电话。
                                  InvoiceNo:
                                    type: string
                                    description: 发票号码。
                                  PayerRegisterNo:
                                    type: string
                                    description: 购买方开户行及账号。
                                  PayeeName:
                                    type: string
                                    description: 销售方名称。
                                  PayeeAddress:
                                    type: string
                                    description: 销售方地址、电话。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_22_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                FileURL:
                  type: string
                  description: 图片URL地址。
                ds_id:
                  type: string
                FileType:
                  type: string
                  description: 输入的图片格式。
              required:
                - FileURL
                - ds_id
                - FileType
  /2582-21:
    x-pointCode: 21
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 出租车发票识别
      description: |-
        可以准确识别出全国各大城市出租车发票在图像中的位置，支持出租车发票结构化识别，输出发票号码、代码、车号、日期、时间、金额，共6个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr

        输入限制
        请求格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              Invoices:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Items:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          Text:
                                            type: string
                                            description: 发票每个字段信息。
                                          ItemRoi:
                                            type: object
                                            properties:
                                              Angle:
                                                type: number
                                                description: 角度信息。坐标的原点在左上角，与x轴平行的方向角度为0。逆时针旋转角度为负，顺时针旋转角度为正。角度是水平轴（x轴）顺时针旋转，与碰到的第一个边的夹角度数。角度范围-180°~180°。
                                              Center:
                                                type: object
                                                properties:
                                                  Y:
                                                    type: number
                                                    description: 位置框中心点y坐标。
                                                  X:
                                                    type: number
                                                    description: 位置框中心点x坐标。
                                              Size:
                                                type: object
                                                properties:
                                                  W:
                                                    type: number
                                                    description: 位置框宽度。
                                                  H:
                                                    type: number
                                                    description: 位置框高度。
                                    InvoiceRoi:
                                      type: object
                                      properties:
                                        W:
                                          type: number
                                          description: 发票宽度。
                                        H:
                                          type: number
                                          description: 发票高度。
                                        Y:
                                          type: number
                                          description: 发票左上角y坐标。
                                        X:
                                          type: number
                                          description: 发票左上角x坐标。
                                    RotateType:
                                      type: number
                                      description: |-
                                        发票旋转角度。

                                        0：不需要旋转。
                                        1：顺时针旋转90。
                                        2：顺时针旋转180。
                                        3：顺时针旋转270。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_21_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
  /2582-20:
    x-pointCode: 20
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 车牌识别
      description: |-
        可以识别行驶证首页和副页关键字段内容，输出品牌型号、车辆类型、车牌号码、检验记录、核定载质量、核定载人数等21个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr


        输入限制
        图片格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              Plates:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Roi:
                                      type: object
                                      properties:
                                        W:
                                          type: number
                                          description: 车牌号宽度。
                                        H:
                                          type: number
                                          description: 车牌号高度。
                                        Y:
                                          type: number
                                          description: 车牌号左上角y坐标。
                                        X:
                                          type: number
                                          description: 车牌号左上角x坐标。
                                    PlateType:
                                      type: string
                                      description: 车牌类型。包括：小型汽车、新能源车、大型汽车、挂车、教练车、警车、军车、使领馆车、港澳车。
                                    Confidence:
                                      type: number
                                      description: 车牌号码的置信度，取值范围0~1。
                                    PlateNumber:
                                      type: string
                                      description: 车牌号码。
                                    PlateTypeConfidence:
                                      type: number
                                      description: 车牌类型的置信度，取值范围0~1。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_20_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
  /2582-19:
    x-pointCode: 19
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 驾驶证识别
      description: |-
        可以识别行驶证首页和副页关键字段内容，输出品牌型号、车辆类型、车牌号码、检验记录、核定载质量、核定载人数等21个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr


        输入限制
        图片格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              FaceResult:
                                type: object
                                properties:
                                  Name:
                                    type: string
                                    description: 姓名字符串，识别失败时返回NoResult或InvalidInput。
                                  LicenseNumber:
                                    type: string
                                    description: 驾驶证号，识别失败时返回NoResult或InvalidInput。
                                  IssueDate:
                                    type: string
                                    description: 初次发证日期。格式：YYYYMMDD，例如19800101，即1980年01月01日。
                                  EndDate:
                                    type: string
                                    description: 驾驶证有效期时长或有效期截止日期。具体视驾驶证数据格式而定，格式：YYYYMMDD，例如19800101，即1980年01月01日。
                                  StartDate:
                                    type: string
                                    description: 驾驶证有效期开始时间，格式：YYYYMMDD，例如19800101，即1980年01月01日。
                                  Address:
                                    type: string
                                    description: 地址。
                                  Gender:
                                    type: string
                                    description: 性别。
                                  VehicleType:
                                    type: string
                                    description: 驾驶证准驾车型。
                              BackResult:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    ArchiveNumber:
                                      type: string
                                      description: 档案编号。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_19_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ImageURL:
                  type: string
                  description: 图片URL地址。
                Side:
                  type: string
                  description: |-
                    上传照片为行驶证首页或副页。

                    face：首页
                    back：副页
                ds_id:
                  type: string
              required:
                - ImageURL
                - Side
                - ds_id
  /2582-18:
    x-pointCode: 18
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: VIN码识别
      description: |-
        可以识别车辆VIN码，输出车辆VIN码数值。阿里原接口订购地址：https://vision.aliyun.com/ocr


        输入限制
        图片格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              VinCode:
                                type: string
                                description: 识别的车辆VIN码。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_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
  /2582-17:
    x-pointCode: 17
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 行驶证识别
      description: |-
        可以识别行驶证首页和副页关键字段内容，输出品牌型号、车辆类型、车牌号码、检验记录、核定载质量、核定载人数等21个关键字段信息。阿里原接口订购地址：https://vision.aliyun.com/ocr

        输入限制
        图片格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              FaceResult:
                                type: object
                                properties:
                                  IssueDate:
                                    type: string
                                    description: 发证日期，格式：YYYYMMDD，例如19800101，即1980年01月01日。
                                  UseCharacter:
                                    type: string
                                    description: 使用性质。
                                  Owner:
                                    type: string
                                    description: 所有人名称。
                                  EngineNumber:
                                    type: string
                                    description: 发动机号码。
                                  Model:
                                    type: string
                                    description: 品牌型号。
                                  PlateNumber:
                                    type: string
                                    description: 车牌号码。
                                  Address:
                                    type: string
                                    description: 地址。
                                  RegisterDate:
                                    type: string
                                    description: 注册日期，格式：YYYYMMDD，例如19800101，即1980年01月01日。
                                  VehicleType:
                                    type: string
                                    description: 车辆类型。
                                  Vin:
                                    type: string
                                    description: 车辆识别代号。
                              BackResult:
                                type: object
                                properties:
                                  ApprovedLoad:
                                    type: string
                                    description: 核定载质量。
                                  ApprovedPassengerCapacity:
                                    type: string
                                    description: 核定载人数。
                                  EnergyType:
                                    type: string
                                    description: 能源标志。
                                  FileNumber:
                                    type: string
                                    description: 档案编号。
                                  GrossMass:
                                    type: string
                                    description: 总质量。
                                  InspectionRecord:
                                    type: string
                                    description: 检验记录。
                                  OverallDimension:
                                    type: string
                                    description: 外廓尺寸。
                                  PlateNumber:
                                    type: string
                                    description: 号牌号码。
                                  TractionMass:
                                    type: string
                                    description: 准牵引总质量。
                                  UnladenMass:
                                    type: string
                                    description: 整备质量。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_17_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ImageURL:
                  type: string
                  description: 图片URL地址。
                Side:
                  type: string
                  description: |-
                    上传照片为行驶证首页或副页。

                    face：首页
                    back：副页
                ds_id:
                  type: string
              required:
                - ImageURL
                - Side
                - ds_id
  /2582-16:
    x-pointCode: 16
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 查询异步任务结果
      description: 异步接口调用API接口后，返回的并不是真正的请求结果，您需要保存返回结果中的RequestId，然后调用本接口来获取真正的请求结果。阿里原接口订购地址：https://vision.aliyun.com/ocr
      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: |-
                                  异步任务状态。包括：

                                  QUEUING：任务排队中
                                  PROCESSING：异步处理中
                                  PROCESS_SUCCESS：处理成功
                                  PROCESS_FAILED：处理失败
                                  TIMEOUT_FAILED：任务超时未处理完成
                                  LIMIT_RETRY_FAILED：超过最大重试次数
                              JobId:
                                type: string
                                description: 异步任务Id。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_16_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
  /2582-11:
    x-pointCode: 11
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 通用识别
      description: |-
        可以识别图像中文字内容和文字区域坐标，适用于多场景图像文字识别。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeCharacter
        输入限制
        请求格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              Results:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    Probability:
                                      type: number
                                      description: 文字内容的概率，取值范围为0~1。
                                    Text:
                                      type: string
                                      description: 文字内容。
                                    TextRectangles:
                                      type: object
                                      properties:
                                        Angle:
                                          type: number
                                          description: 文字区域角度，角度范围[-180, 180]。
                                        Top:
                                          type: number
                                          description: 文字区域左上角y坐标。
                                        Height:
                                          type: number
                                          description: 文字区域高度。
                                        Width:
                                          type: number
                                          description: 文字区域宽度。
                                        Left:
                                          type: number
                                          description: 文字区域左上角x坐标。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_11_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ImageURL:
                  type: string
                  description: 图片URL地址。
                MinHeight:
                  type: string
                  description: 图片中文字的最小高度，单位像素。
                OutputProbability:
                  type: string
                  description: 是否输出文字框的概率。取值true或者false。
                ds_id:
                  type: string
              required:
                - ImageURL
                - MinHeight
                - OutputProbability
                - ds_id
  /2582-10:
    x-pointCode: 10
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 表格识别
      description: |-
        可以自动识别表格位置、表格内容信息。适用于黑色的，横线、竖线都齐全的表格中内容识别。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeTable

        输入限制
        请求格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              Tables:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    TableRows:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          TableColumns:
                                            type: array
                                            items:
                                              type: object
                                              properties:
                                                Texts:
                                                  type: array
                                                  items:
                                                    type: string
                                                  description: 文本，每行（row）文字为一个block。
                                                EndRow:
                                                  type: number
                                                  description: 单元格所占的行数（rowspan）为ey-sy。
                                                StartRow:
                                                  type: number
                                                  description: 单元格的起始行ID。
                                                Height:
                                                  type: number
                                                  description: 图片上单元格的高度。
                                                Width:
                                                  type: number
                                                  description: 图片上单元格的宽度。
                                                StartColumn:
                                                  type: number
                                                  description: 单元格的起始列ID。
                                                EndColumn:
                                                  type: number
                                                  description: 单元格所占的列数（colspan）为ex-sx。
                                    Head:
                                      type: string
                                      description: 表头信息。
                                    Tail:
                                      type: string
                                      description: 表尾信息。
                              FileContent:
                                type: string
                                description: HTML字符串。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_10_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ImageURL:
                  type: string
                  description: 图片URL地址。
                AssureDirection:
                  type: string
                  description: |-
                    图片方向是否确定为正向。

                    true：确定
                    false：不确定
                HasLine:
                  type: string
                  description: |-
                    是否无线条。

                    true：无线条或者只有横线没有竖线。
                    false：有线条。
                ds_id:
                  type: string
                OutputFormat:
                  type: string
                  description: 输出格式。包括：html、json、xlsx。
                SkipDetection:
                  type: string
                  description: 是否跳过检测，取值true或false。
                UseFinanceModel:
                  type: string
                  description: 是否使用财务报表模型。取值true或false。
              required:
                - ImageURL
                - AssureDirection
                - HasLine
                - ds_id
                - OutputFormat
                - SkipDetection
                - UseFinanceModel
  /2582-7:
    x-pointCode: 7
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 二维码识别
      description: |-
        可以识别图像中是否含有二维码信息，输出图像中二维码包含的文本信息（每个二维码对应的URL或文本），可支持图像中含有多个二维码识别。阿里原接口订购地址：https://vision.aliyun.com/ocr?spm=a211p3.14020179.J_7524944390.2.66cd4850CPBaJQ

        输入限制
        图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP。
        图片大小：大小不超过10MB。如您有大图需求，请提工单申请。
        图片分辨率：建议不低于256×256像素，分辨率过低可能会影响识别效果。
        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地址。
                                    TaskId:
                                      type: string
                                      description: 该检测任务的ID。
                                    Results:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          Suggestion:
                                            type: string
                                            description: |-
                                              建议您执行的操作，取值包括：

                                              pass：图片正常，无需进行其余操作。
                                              review：检测结果不确定，需要进行人工审核。
                                              block：图片违规，建议执行进一步操作（如直接删除或做限制处理）。
                                          Label:
                                            type: string
                                            description: |-
                                              检测结果的分类，取值包括：

                                              normal：正常图片。
                                              qrcode：含二维码的图片。
                                              programCode：含小程序码的图片。
                                              说明 默认不识别小程序码。如果需要识别，请提工单申请。
                                          Rate:
                                            type: number
                                            description: 结果为该分类的概率，取值范围为[0.00-100.00]。值越高，表示属于该分类的概率越大。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_7_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
  /2582-5:
    x-pointCode: 5
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 银行卡识别
      description: |-
        可以检测输入的主流银行卡图像，输出3个信息，包括：发卡行、银行卡号、有效日期。阿里原接口订购地址：https://vision.aliyun.com/ocr?spm=a211p3.14020179.J_7524944390.2.66cd4850CPBaJQ

        输入限制
        图片格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过3M。
        图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。
        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:
                              CardNumber:
                                type: string
                                description: 银行卡号。
                              ValidDate:
                                type: string
                                description: 有效日期，识别失败则返回空字符串。如有多个，则用逗号分隔，例如03/17,04/05。
                              BankName:
                                type: string
                                description: 银行名称，识别失败则返回空字符串。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_5_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
  /2582-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 身份证识别
      description: |-
        可以识别二代身份证关键字段内容，关键字段包括：姓名、性别、民族、身份证号、出生日期、地址信息、有效起始时间、签发机关，同时可输出身份证区域位置和人脸位置信息。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeIdentityCard

        输入限制：
        图片格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              FrontResult:
                                type: object
                                properties:
                                  CardAreas:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        Y:
                                          type: number
                                          description: 身份证区域纵坐标。
                                        X:
                                          type: number
                                          description: 身份证区域横坐标。
                                  Name:
                                    type: string
                                    description: 姓名。
                                  IDNumber:
                                    type: string
                                    description: 身份证号。
                                  Address:
                                    type: string
                                    description: 地址信息。
                                  Gender:
                                    type: string
                                    description: 性别。
                                  BirthDate:
                                    type: string
                                    description: 出生日期，格式：YYYYMMDD，例如19800101，即1980年01月01日。
                                  FaceRectangle:
                                    type: object
                                    properties:
                                      Angle:
                                        type: number
                                        description: 表示矩形顺时针旋转的度数，范围-180~180。
                                      Center:
                                        type: object
                                        properties:
                                          Y:
                                            type: number
                                            description: 人脸矩形中心纵坐标。
                                          X:
                                            type: number
                                            description: 人脸矩形中心横坐标。
                                      Size:
                                        type: object
                                        properties:
                                          Height:
                                            type: number
                                            description: 高度。
                                          Width:
                                            type: number
                                            description: 宽度。
                                  FaceRectVertices:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        Y:
                                          type: number
                                          description: 人脸位置纵坐标。
                                        X:
                                          type: number
                                          description: 人脸位置横坐标。
                                  Nationality:
                                    type: string
                                    description: 民族。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_3_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ImageURL:
                  type: string
                  description: 图片URL地址。
                Side:
                  type: string
                  description: |-
                    身份证正反面类型。

                    face：正面。
                    back：反面。
                ds_id:
                  type: string
              required:
                - ImageURL
                - Side
                - ds_id
  /2582-2:
    x-pointCode: 2
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 营业执照识别
      description: |-
        可以识别营业执照关键字段内容，包括：公司地址、营业范围、注册资本、注册日期、公司法人、公司名称、注册号、公司类型、公司营业期限日期。同时可以输出营业执照上二维码、印章位置。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=ocr&children=RecognizeBusinessLicense

        输入限制
        请求格式：JPEG、JPG、PNG、BMP、GIF。
        图像大小：图像大小不超过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:
                              LegalPerson:
                                type: string
                                description: 公司法人。识别失败时时返回FailInRecognition。
                              Business:
                                type: string
                                description: 经营范围，识别失败时返回FailInRecognition。
                              QRCode:
                                type: object
                                properties:
                                  Top:
                                    type: number
                                    description: 区域左上角y坐标。
                                  Height:
                                    type: number
                                    description: 区域高度。
                                  Width:
                                    type: number
                                    description: 区域宽度。
                                  Left:
                                    type: number
                                    description: 区域左上角x坐标。
                              EstablishDate:
                                type: string
                                description: 公司注册日期。例如证件上为“2014年04月16日”，则接口返回“20140416”。
                              Type:
                                type: string
                                description: 公司类型。识别失败时返回FailInRecognition。
                              Capital:
                                type: string
                                description: 注册资本，识别失败时返回FailInRecognition。
                              Title:
                                type: object
                                properties:
                                  Top:
                                    type: number
                                    description: 区域左上角y坐标。
                                  Height:
                                    type: number
                                    description: 区域高度。
                                  Width:
                                    type: number
                                    description: 区域宽度。
                                  Left:
                                    type: number
                                    description: 区域左上角x坐标。
                              Name:
                                type: string
                                description: 公司名称。识别失败时返回FailInRecognition。
                              Angle:
                                type: number
                                description: 输入图片的角度（顺时针旋转）。枚举值包括：0、90、180、270。
                              Stamp:
                                type: object
                                properties:
                                  Top:
                                    type: number
                                    description: 区域左上角y坐标。
                                  Height:
                                    type: number
                                    description: 区域高度。
                                  Width:
                                    type: number
                                    description: 区域宽度。
                                  Left:
                                    type: number
                                    description: 区域左上角x坐标。
                              ValidPeriod:
                                type: string
                                description: |-
                                  公司营业期限终止日期。例如证件上为“2014年04月16日至2034年04月15日”，则接口返回“20340415”。

                                  说明 当前算法将日期格式统一输出为“年月日”（例如“20391130”），并用“29991231”表示“长期”，若证件上没有营业期限，则默认其为“长期”返回“29991231”。
                              Address:
                                type: string
                                description: 公司地址。识别失败时返回FailInRecognition。
                              RegisterNumber:
                                type: string
                                description: 注册号。识别失败时返回FailInRecognition。
                              Emblem:
                                type: object
                                properties:
                                  Top:
                                    type: number
                                    description: 区域左上角y坐标。
                                  Height:
                                    type: number
                                    description: 区域高度。
                                  Width:
                                    type: number
                                    description: 区域宽度。
                                  Left:
                                    type: number
                                    description: 区域左上角x坐标。
                          ret_code:
                            type: number
                          remark:
                            type: string
                          RequestId:
                            type: string
                        description: 业务返回体
      operationId: 2582_2_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/2582?tab=book
x-apiCode: "2582"
x-is-own: false
x-is-op: true
