# Generated by ShowAPI OpenAPI generator
# source: market/2553
# generated-at: 2026-06-26T06:46:02.199Z
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:
  /2553-9:
    x-pointCode: 9
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 不良行为识别
      description: 原接口订购地址：https://cloud.tencent.com/product/tiia
      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
                          remark:
                            type: string
                          Response:
                            type: object
                            properties:
                              Confidence:
                                type: number
                                description: 对于图片中包含不良行为的置信度，取值[0,1]，一般超过0.5则表明可能包含不良行为内容；
                              Type:
                                type: string
                                description: 图像中最可能包含的不良行为类别，包括赌博、打架斗殴、吸毒等。
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                        description: 业务返回体
      operationId: 2553_9_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: 图片的URL地址。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
              required:
                - ds_id
  /2553-8:
    x-pointCode: 8
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 恶心检测
      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
                          remark:
                            type: string
                          Response:
                            type: object
                            properties:
                              Confidence:
                                type: number
                                description: 对于图片中包含恶心内容的置信度，取值[0,1]，一般超过0.5则表明可能是恶心图片。
                              Type:
                                type: string
                                description: 与图像内容最相似的恶心内容的类别，包含腐烂、密集、畸形、血腥、蛇、虫子、牙齿等。
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                        description: 业务返回体
      operationId: 2553_8_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: 图片的URL地址。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
              required:
                - ds_id
  /2553-7:
    x-pointCode: 7
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 图片智能裁剪
      description: 原接口订购地址：https://cloud.tencent.com/product/tiia
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              X:
                                type: number
                                description: 裁剪区域左上角X坐标值
                              Y:
                                type: number
                                description: 裁剪区域左上角Y坐标值
                              Width:
                                type: number
                                description: 裁剪区域的宽度，单位为像素
                              Height:
                                type: number
                                description: 裁剪区域的高度，单位为像素
                              OriginalWidth:
                                type: number
                                description: 原图宽度，单位为像素
                              OriginalHeight:
                                type: number
                                description: 原图高度，单位为像素
                              CropResult:
                                type: number
                                description: |-
                                  0：抠图正常；
                                  1：原图过长，指原图的高度是宽度的1.8倍以上；
                                  2：原图过宽，指原图的宽度是高度的1.8倍以上；
                                  3：抠图区域过长，指抠图的高度是主体备选框高度的1.6倍以上；
                                  4：抠图区域过宽，指当没有检测到人脸时，抠图区域宽度是检测出的原图主体区域宽度的1.6倍以上；
                                  5：纯色图，指裁剪区域视觉较为单一、缺乏主体部分 ；
                                  6：宽高比异常，指Width : Height取值超出[1, 2.5]的范围；

                                  以上是辅助决策的参考建议，可以根据业务需求选择采纳或忽视。
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                          remark:
                            type: string
                          ret_code:
                            type: number
                        description: 业务返回体
      operationId: 2553_7_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: 图片的URL地址。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Width:
                  type: number
                  description: |-
                    需要裁剪区域的宽度，与Height共同组成所需裁剪的图片宽高比例；
                    输入数字请大于0、小于图片宽度的像素值；
                Height:
                  type: number
                  description: |-
                    需要裁剪区域的高度，与Width共同组成所需裁剪的图片宽高比例；
                    输入数字请请大于0、小于图片高度的像素值；
                    宽高比例（Width : Height）会简化为最简分数，即如果Width输入10、Height输入20，会简化为1：2。
                    Width : Height建议取值在[1, 2.5]之间，超过这个范围可能会影响效果；
              required:
                - ds_id
                - Width
                - Height
  /2553-6:
    x-pointCode: 6
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 图像质量评估
      description: 原接口订购地址：https://cloud.tencent.com/product/tiia
      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
                          remark:
                            type: string
                          Response:
                            type: object
                            properties:
                              PureImage:
                                type: boolean
                                description: 取值为TRUE或FALSE，TRUE为纯色图或纯文字图，即没有内容或只有简单内容的图片，FALSE为正常图片。
                              ClarityScore:
                                type: number
                                description: 综合评分。图像清晰度的得分，对图片的噪声、曝光、模糊、压缩等因素进行综合评估，取值为[0, 100]，值越大，越清晰。一般大于50为较清晰图片，标准可以自行把握。
                              AestheticScore:
                                type: number
                                description: 综合评分。图像美观度得分， 从构图、色彩等多个艺术性维度评价图片，取值为[0, 100]，值越大，越美观。一般大于50为较美观图片，标准可以自行把握。
                              SmallImage:
                                type: boolean
                                description: 取值为TRUE或FALSE，TRUE为小图，FALSE为否, 小图定义为最长边小于179像素的图片。当一张图片被判断为小图时，不建议做推荐和展示，其他字段统一输出为0或FALSE。
                              BigImage:
                                type: boolean
                                description: 取值为TRUE或FALSE，TRUE为大图，FALSE为否，定义为最短边大于1000像素的图片
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                              LongImage:
                                type: boolean
                                description: 取值为TRUE或FALSE，TRUE为长图，FALSE为正常图，长图定义为长宽比大于等于3或小于等于1/3的图片。
                              BlackAndWhite:
                                type: boolean
                                description: 取值为TRUE或FALSE，TRUE为黑白图，FALSE为否。黑白图即灰度图，指红绿蓝三个通道都是以灰度色阶显示的图片，并非视觉上的“黑白图片”。
                        description: 业务返回体
      operationId: 2553_6_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: |-
                    图片URL地址。
                    图片限制：
                    • 图片格式：PNG、JPG、JPEG。
                    • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。
                    建议：
                    • 图片像素：大于50*50像素，否则影响识别效果；
                    • 长宽比：长边：短边<5；
                    接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。
                    注意：图片需要base64编码，并且要去掉编码头部。
              required:
                - ds_id
  /2553-5:
    x-pointCode: 5
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 图像标签
      description: 原接口订购地址：https://cloud.tencent.com/product/tiia
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              Labels:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Confidence:
                                          type: number
                                          description: 算法对于Name的置信度，0-100之间，值越高，表示对于Name越确定。
                                        Name:
                                          type: string
                                          description: 图片中的物体名称。
                                description: 标签结果数组
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                          remark:
                            type: string
                            description: 返回说明
                          ret_code:
                            type: number
                            description: 返回标识，0为成功，其余为失败！
                        description: 业务返回体
      operationId: 2553_5_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: 图片的URL地址。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
              required:
                - ds_id
  /2553-4:
    x-pointCode: 4
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 商品识别
      description: 原接口订购地址：https://cloud.tencent.com/product/tiia
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              Products:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Confidence:
                                          type: number
                                          description: 算法对于Name的置信度，0-100之间，值越高，表示对于Name越确定
                                        Name:
                                          type: string
                                          description: 图片中商品的三级分类识别结果，选取所有三级分类中的置信度最大者
                                        Parents:
                                          type: string
                                          description: 三级商品分类对应的一级分类和二级分类，两级之间用“-”（中划线）隔开，例如商品名称是“硬盘”，那么Parents输出为“电脑、办公-电脑配件”
                                        XMax:
                                          type: number
                                          description: 商品坐标X轴的最大值
                                        XMin:
                                          type: number
                                          description: 商品坐标X轴的最小值
                                        YMax:
                                          type: number
                                          description: 商品坐标Y轴的最大值
                                        YMin:
                                          type: number
                                          description: 商品坐标Y轴的最小值
                                description: 商品识别结果数组
                              RequestId:
                                type: string
                          remark:
                            type: string
                          ret_code:
                            type: number
                        description: 业务返回体
      operationId: 2553_4_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: 图片的URL地址。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
              required:
                - ds_id
  /2553-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 车辆识别
      description: 原接口订购地址：https://cloud.tencent.com/product/tiia
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              CarCoords:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        X:
                                          type: number
                                          description: 横坐标x
                                        Y:
                                          type: number
                                          description: 纵坐标y
                                description: 汽车的四个矩形顶点坐标
                              CarTags:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Brand:
                                          type: string
                                          description: 车辆品牌
                                        Color:
                                          type: string
                                          description: 车辆颜色
                                        Confidence:
                                          type: number
                                          description: 置信度，0-100
                                        Serial:
                                          type: string
                                          description: 车系
                                        Type:
                                          type: string
                                          description: 车辆类型
                                        Year:
                                          type: number
                                          description: 年份，没识别出年份的时候返回0
                                description: "\t车辆属性识别的结果数组"
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                          remark:
                            type: string
                          ret_code:
                            type: number
                        description: 业务返回体
      operationId: 2553_3_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: 图片的URL地址。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
              required:
                - ds_id
  /2553-1:
    x-pointCode: 1
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 图像清晰度增强
      description: 原接口订购地址：https://cloud.tencent.com/product/tiia
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              EnhancedImage:
                                type: string
                                description: 增强后图片的base64编码。
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                          remark:
                            type: string
                          ret_code:
                            type: number
                        description: 业务返回体
      operationId: 2553_1_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ImageUrl:
                  type: string
                  description: 图片的URL地址。支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                ImageBase64:
                  type: string
                  description: |-
                    图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
              required:
                - 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/2553?tab=book
x-apiCode: "2553"
x-is-own: false
x-is-op: true
