# Generated by ShowAPI OpenAPI generator
# source: market/1754
# generated-at: 2026-06-26T01:56:19.860Z
openapi: 3.0.3
info:
  title: 生活类图片OCR识别
  description: 菜品识别-动植物识别-商品识别-水果识别等。基于行业前沿的人工智能技术，为用户提供菜品、水果、logo、动物、植物、货币、地标、商品等的识别服务。广泛应用于数字营销、新零售、广告设计、园林景观等行业场景。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /1754-16:
    x-pointCode: 16
    x-mode: mapping
    x-read-timeout: 10
    x-connect-timeout: 10
    post:
      summary: 水果识别
      description: 是一款基于人工智能和深度学习算法的图像识别接口，能够识别出图片中的水果名称和置信度。该接口适用于各种场景，如智能农业、零售业、食品安全等，可以帮助用户快速、准确地识别水果种类。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          result:
                            type: array
                            items:
                              type: object
                              properties:
                                confidence_level:
                                  type: number
                                  description: 置信度，值在0-1之间
                                name:
                                  type: string
                                  description: 识别出的水果
                            description: 识别结果集
                          ret_code:
                            type: number
                            description: |-
                              ret_code = 0 无异常
                              10 参数错误   
                              20 文件格式错误  
                              30 操作失败,请勿重复提交
                              40 文件下载失败
                              50 文件内容过大
                              60 图片解析失败
                              70 识别失败
                              80 服务超时
                              90 未知错误(error_code)
                          remark:
                            type: string
                            description: 错误信息
                        description: 业务返回体
      operationId: 1754_16_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: |-
                    
                    要识别图片的base64字符串，与img_url参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
  /1754-15:
    x-pointCode: 15
    x-mode: mapping
    x-read-timeout: 15
    x-connect-timeout: 5
    post:
      summary: 通用图像打标
      description: 是一款先进的图像识别技术，能够对输入的图像进行精准的标签识别，并提供标签结果和置信度。该技术基于深度学习和人工智能算法，可以自动学习和识别图像中的各种特征，从而实现对图像内容的准确描述。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          result:
                            type: array
                            items:
                              type: object
                              properties:
                                confidence_level:
                                  type: number
                                  description: 置信度 值在0-1之间
                                name:
                                  type: string
                                  description: 标签结果
                            description: 结果集合，识别失败时可能返回空集合
                          ret_code:
                            type: number
                            description: |2-
                               0 无异常
                              10 参数错误   
                              20 文件格式错误  
                              30 操作失败,请勿重复提交
                              40 文件下载失败
                              50 文件内容过大
                              60 图片解析失败
                              70 识别失败
                              80 服务超时
                              90 未知错误(error_code)
                          remark:
                            type: string
                            description: 错误信息
                        description: 业务返回体
      operationId: 1754_15_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: |-
                    
                    要识别图片的base64字符串，与img_url参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
  /1754-14:
    x-pointCode: 14
    x-mode: mapping
    x-read-timeout: 10
    x-connect-timeout: 10
    post:
      summary: 垃圾分类
      description: 是一款利用先进的人工智能技术和图像识别算法，帮助用户识别出物品名称、垃圾回收类型和置信度。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          results:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                  description: 识别的物品名称
                                type:
                                  type: string
                                  description: 垃圾分类,包括:可回收垃圾、干垃圾、湿垃圾、有害垃圾
                                confidence_level:
                                  type: number
                                  description: 置信度
                            description: 识别结果列表
                          ret_code:
                            type: number
                            description: 0表示成功，-1表示失败
                        description: 业务返回体
      operationId: 1754_14_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 识别图片的base64字符串，img_url和img_base64二选一输入
                img_url:
                  type: string
                  description: 识别图片的URL地址，img_url和img_base64二选一输入
  /1754-13:
    x-pointCode: 13
    x-mode: mapping
    x-read-timeout: 60
    x-connect-timeout: 5
    post:
      summary: 商品识别(位置版)
      description: 能有效识别出图片中的主体位置、商品类型，输出商品的价格、型号等详细信息。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          results:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                  description: 商品名称
                                confidence_level:
                                  type: number
                                  description: 置信度
                                range:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      x:
                                        type: number
                                        description: 该点距离图片左侧的像素
                                      y:
                                        type: number
                                        description: 该点距离图片顶部的像素
                                  description: 识别物品所在区域,用四个像素点来表示
                            description: 识别的商品列表
                        description: 业务返回体
      operationId: 1754_13_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 识别图片的base64字符串，img_url和img_base64二选一输入
                img_url:
                  type: string
                  description: 识别图片的URL地址，img_url和img_base64二选一输入
  /1754-12:
    x-pointCode: 12
    x-mode: mapping
    x-read-timeout: 10
    x-connect-timeout: 5
    post:
      summary: 商品识别(标准版)
      description: 能识别图片中的商品，输出商品的品名称、类别，还可以输出商品在图片中的位置。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          results:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                  description: 识别的物品名称
                                confidence_level:
                                  type: number
                                  description: 置信度
                            description: 识别结果列表
                        description: 业务返回体
      operationId: 1754_12_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 识别图片的URL地址，img_url和img_base64二选一输入
                img_url:
                  type: string
                  description: 识别图片的base64字符串编码，img_url和img_base64二选一输入
  /1754-11:
    x-pointCode: 11
    x-mode: mapping
    x-read-timeout: 10
    x-connect-timeout: 10
    post:
      summary: 地标识别
      description: 即对于输入的一张图片（可正常解码，且长宽比适宜），输出图片中的地标识别结果
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          name:
                            type: string
                            description: 识别结果
                          ret_code:
                            type: number
                            description: |-
                              ret_code = 0 无异常
                              10 参数错误   
                              20 文件格式错误  
                              30 操作失败,请勿重复提交
                              40 文件下载失败
                              50 文件内容过大
                              60 图片解析失败
                              70 识别失败
                              80 服务超时
                              90 未知错误(error_code)
                          remark:
                            type: string
                            description: 错误信息
                        description: 业务返回体
      operationId: 1754_11_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 要识别图片的Base64编码字符串，注意不需要base64,等修饰符，无默认出参URLencode的的客户端，例如PHP，需对该值进行URLencode
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
  /1754-10:
    x-pointCode: 10
    x-mode: mapping
    x-read-timeout: 60
    x-connect-timeout: 60
    post:
      summary: 货币识别(纸币)
      description: 货币识别技术利用人工智能和图像处理，快速扫描并分析纸币的正反面特征，以验证其真伪并识别种类。通过与数据库中的货币信息进行比对，货币识别系统能够准确判断出纸币的种类和真伪。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          name:
                            type: string
                            description: 货币名称
                          year:
                            type: string
                            description: 货币发行版本
                          denomination:
                            type: string
                            description: 面值
                          code:
                            type: string
                            description: 货币代码，可能为空字符串
                          remark:
                            type: string
                            description: 错误信息
                          ret_code:
                            type: number
                            description: |-
                              ret_code = 0 无异常
                              10 参数错误   
                              20 文件格式错误  
                              30 操作失败,请勿重复提交
                              40 文件下载失败
                              50 文件内容过大
                              60 图片解析失败
                              70 识别失败
                              80 服务超时
                              90 未知错误(error_code)
                        description: 业务返回体
      operationId: 1754_10_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 要识别图片的Base64编码字符串，注意不需要base64,等修饰符，无默认出参URLencode的的客户端，例如PHP，需对该值进行URLencode
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
  /1754-7:
    x-pointCode: 7
    x-mode: mapping
    x-read-timeout: 50
    x-connect-timeout: 50
    post:
      summary: 植物识别
      description: 传入一个植物图片的Base64字符串，长宽比例合适，我们可以输出对该植物的识别结果
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: number
                            description: |
                              ret_code = 0 无异常
                              10 参数错误   
                              20 文件格式错误  
                              30 操作失败,请勿重复提交
                              40 文件下载失败
                              50 文件内容过大
                              60 图片解析失败
                              70 识别失败
                              80 服务超时
                              90 未知错误(error_code)
                          remark:
                            type: string
                            description: 错误信息
                          result:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                  description: 植物名称
                                score:
                                  type: number
                                  description: 置信度，值在0-1之间
                                desc:
                                  type: string
                                  description: 植物介绍，可能返回空字符串
                            description: 植物识别结果List，没有识别成功时可能返回空集合
                        description: 业务返回体
      operationId: 1754_7_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 植物图片的Base64编码字符串，注意转码后得到的字符串一般不用进行urlencode，也就是说上传的base64字符串中含有+和/字符。png格式图片base64一般以iVBO开头，jpg图片的base64一般以/9j/开头，在此之前的修饰字符都是多余的，上传时必须去除。
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
  /1754-6:
    x-pointCode: 6
    x-mode: mapping
    x-read-timeout: 60
    x-connect-timeout: 20
    post:
      summary: 动物识别
      description: 基于人工智能技术的服务接口，它允许用户上传动物图片，并通过先进的图像识别算法来识别出动物名称、置信度和动物描述。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          result:
                            type: array
                            items:
                              type: object
                              properties:
                                confidence_level:
                                  type: number
                                  description: 置信度 值在0-1之间
                                desc:
                                  type: string
                                  description: 动物描述，可能返回空字符串
                                name:
                                  type: string
                                  description: 识别动物名称
                            description: 识别结果集可能为空
                          ret_code:
                            type: number
                            description: |
                              ret_code = 0 无异常
                              10 参数错误   
                              20 文件格式错误  
                              30 操作失败,请勿重复提交
                              40 文件下载失败
                              50 文件内容过大
                              60 图片解析失败
                              70 识别失败
                              80 服务超时
                              90 未知错误(error_code)
                          remark:
                            type: string
                            description: 错误信息
                        description: 业务返回体
      operationId: 1754_6_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图片Base64字符串，注意转码后得到的字符串一般不用进行urlencode，也就是说上传的base64字符串中含有+和/字符。png格式图片base64一般以iVBO开头，jpg图片的base64一般以/9j/开头，在此之前的修饰字符都是多余的，上传时必须去除。
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
  /1754-5:
    x-pointCode: 5
    x-mode: mapping
    x-read-timeout: 60
    x-connect-timeout: 20
    post:
      summary: Logo识别
      description: "该子接口用于检测和识别图片中的品牌LOGO信息\r

        即上传一张图片（可正常解码，且长宽比适宜，进行正确的Base64编码），输出图片中LOGO的名称、位置和置信度"
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: number
                            description: 0表示成功
                          remark:
                            type: string
                            description: 错误信息
                          result:
                            type: array
                            items:
                              type: object
                              properties:
                                range:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      x:
                                        type: number
                                        description: x轴坐标
                                      y:
                                        type: number
                                        description: y轴坐标
                                  description: 坐标信息list，返回四个坐标，从左上角第一个点开始顺时针排列
                                name:
                                  type: string
                                  description: 品牌名称
                                confidence_level:
                                  type: number
                                  description: 置信度 0-1之间
                            description: 识别结果List，（可能有多个）
                        description: 业务返回体
      operationId: 1754_5_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图片的Base64编码，注意转码后得到的字符串一般不用进行urlencode，也就是说上传的base64字符串中含有+和/字符。png格式图片base64一般以iVBO开头，jpg图片的base64一般以/9j/开头，在此之前的修饰字符都是多余的，上传时必须去除。
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
  /1754-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 60
    x-connect-timeout: 20
    post:
      summary: 菜品识别
      description: 您在这个接口上传一张菜品的图片（可正常解码，且长宽比适宜），我们就输出图片的菜品名称、卡路里信息、置信度。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: number
                            description: |
                              0表示识别成功，
                              10 参数错误   
                              20 文件格式错误  
                              30 操作失败,请勿重复提交
                              40 文件下载失败
                              50 文件内容过大
                              60 图片解析失败
                              70 识别失败
                              80 服务超时
                              90 未知错误(error_code)
                          results:
                            type: array
                            items:
                              type: object
                              properties:
                                confidence_level:
                                  type: number
                                  description: 置信度 (0-1)
                                name:
                                  type: string
                                  description: 识别菜品结果
                                calorie:
                                  type: string
                                  description: 所含卡路里参考值
                            description: 识别结果集合，没有识别到菜品时，可能为空
                          remark:
                            type: string
                            description: 错误信息
                        description: 业务返回体
      operationId: 1754_3_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                img_base64:
                  type: string
                  minLength: 0
                  maxLength: 1000000
                  description: 要识别图片的base64字符串，与img_url参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
                img_url:
                  type: string
                  description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片
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/1754?tab=book
x-apiCode: "1754"
x-is-own: true
x-is-op: true
