# Generated by ShowAPI OpenAPI generator # source: market/1754 # generated-at: 2026-07-26T04:02:43.333Z 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: false x-is-op: false