{ "name": "tiia", "display_name": "图像分析", "description": "介绍如何使用API对图像分析进行操作，包括图像质量检测、图像理解等。", "domain": "ai", "api_version": "2019-05-29", "endpoint": "tiia.tencentcloudapi.com", "actions": [ { "name": "AssessQuality", "description": "评估输入图片在视觉上的质量，从多个方面评估，并同时给出综合的、客观的清晰度评分，和主观的美观度评分。 \u003e - 可前往 [图像处理](https://cloud.tencent.com/document/product/1590) 产品文档中查看更多产品信息。 - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果。 • 长宽比：长边：短边\u003c5。 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过Base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 **注意：图片需要Base64编码，并且要去掉编码头部。**", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "CreateGroup", "description": "本接口用于创建一个空的图片库，图片库主要用于存储在创建图片时提取的图片特征数据，如果图片库已存在则返回错误。不同的图片库类型对应不同的图像搜索服务类型，根据输入参数GroupType区分。 服务类型GroupType功能描述 通用图像搜索 4 通用图像搜索1.0版。在自建图片库中搜索相同原图或相似图片集，并给出相似度打分，可支持裁剪、翻转、调色、加水印等二次编辑后的...", "status": "online", "parameters": [ { "name": "GroupId", "type": "string", "required": true, "description": "图库ID，不可重复，仅支持字母、数字和下划线。图库数量单个用户上限为30。", "example": "test_group" }, { "name": "GroupName", "type": "string", "required": true, "description": "图库名称描述。", "example": "示例图库" }, { "name": "MaxCapacity", "type": "integer", "required": true, "description": "图片库可容纳的最大图片特征条数，一张图片对应一条图片特征数据，不支持修改。 单个图片库容量最大可达亿级，达到容量限制后继续创建图片将会报错。 注意，包月计费下支持绑定的最小库容量为500万。", "example": "100" }, { "name": "Brief", "type": "string", "required": false, "description": "图库简介。", "example": "示例用图库" }, { "name": "MaxQps", "type": "integer", "required": false, "description": "访问限制默认为10qps，如需扩容请联系[在线客服](https://cloud.tencent.com/online-service)申请。", "example": "10" }, { "name": "GroupType", "type": "integer", "required": false, "description": "图库类型，用于决定图像搜索的服务类型和算法版本，默认为4。 GroupType不支持修改，若不确定适用的服务类型，建议先对不同类型分别小规模测试后再开始正式使用。 参数取值： 4：通用图像搜索1.0版。 8：商品图像搜索3.0升级版。 7：商品图像搜索2.0版。 5：商品图像搜索1.0版。 6：图案花纹搜索1.0版。 1 - 3：通用图像搜索旧版，不推荐使用。", "example": "1" } ], "required": [ "GroupId", "GroupName", "MaxCapacity" ] }, { "name": "CreateImage", "description": "创建图片，并添加对应图片的自定义信息。模型将在创建图片时自动提取图像特征并存储到指定的图片库中，每创建一张图片会对应提取和存储一条图片特征数据。 \u003e - 可前往 [图像搜索](https://cloud.tencent.com/document/product/1589) 产品文档中查看更多产品信息。", "status": "online", "parameters": [ { "name": "GroupId", "type": "string", "required": true, "description": "图库ID。", "example": "test_group" }, { "name": "EntityId", "type": "string", "required": true, "description": "物品ID，最多支持64个字符。 一个物品ID可以包含多张图片，若EntityId已存在，则对其追加图片。同一个EntityId，最大支持10张图。", "example": "test_entity" }, { "name": "PicName", "type": "string", "required": true, "description": "图片名称，最多支持64个字符， PicName唯一确定一张图片，具有唯一性。", "example": "new_pic" }, { "name": "ImageUrl", "type": "string", "required": false, "description": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096\\*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\\*2000，图片长宽比小于10。 建议： • 图片存储于腾讯\ufffd...", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "CustomContent", "type": "string", "required": false, "description": "图片自定义备注内容，最多支持4096个字符，查询时原样带回。", "example": "备注" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片 base64 数据，base64 编码后大小不可超过5M。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096\\*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\\*2000，图片长宽比小于10。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" }, { "name": "Tags", "type": "string", "required": false, "description": "图片自定义标签，最多不超过10个，格式为JSON。", "example": "{\"test\":\"1\"}" }, { "name": "EnableDetect", "type": "boolean", "required": false, "description": "是否需要启用主体识别，默认为**TRUE**。 • 为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体创建图片并进行主体识别。主体识别结果可在**Response**中获取。 • 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图创建图片。 **注意：仅服务类型为商品图像搜索时才生效。**", "example": "true" }, { "name": "CategoryId", "type": "integer", "required": false, "description": "图像类目ID。 若设置类目ID，提取以下类目的主体创建图片。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 **注意：仅服务类型为商品图像搜索时才生效。**", "example": "1" }, { "name": "ImageRect", "type": "object", "required": false, "description": "图像主体区域。 若设置主体区域，提取指定的区域创建图片。", "example": "{x:100,y:200,width:200,height:200}", "children": [ { "name": "X", "type": "integer", "required": true, "description": "x轴坐标", "example": "100" }, { "name": "Y", "type": "integer", "required": true, "description": "y轴坐标", "example": "100" }, { "name": "Width", "type": "integer", "required": true, "description": "(x,y)坐标距离长度", "example": "200" }, { "name": "Height", "type": "integer", "required": true, "description": "(x,y)坐标距离高度", "example": "200" } ] } ], "required": [ "GroupId", "EntityId", "PicName" ] }, { "name": "CropImage", "description": "根据输入的裁剪比例，智能判断一张图片的最佳裁剪区域，确保原图的主体区域不受影响，以适应不同平台、设备的展示要求，避免简单拉伸带来的变形。 \u003e - 可前往 [图像处理](https://cloud.tencent.com/document/product/1590) 产品文档中查看更多产品信息。 - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "Width", "type": "integer", "required": true, "description": "需要裁剪区域的宽度，与Height共同组成所需裁剪的图片宽高比例。 输入数字请大于0、小于图片宽度的像素值。", "example": "1100" }, { "name": "Height", "type": "integer", "required": true, "description": "需要裁剪区域的高度，与Width共同组成所需裁剪的图片宽高比例。 输入数字请大于0、小于图片高度的像素值。 宽高比例（Width : Height）会简化为最简分数，即如果Width输入10、Height输入20，会简化为1：2。 Width : Height建议取值在[1, 2.5]之间，超过这个范围可能会影响效果。", "example": "880" }, { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果。 • 长宽比：长边：短边\u003c5。 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过Base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 注意：图片需要Base64编码，并且要去掉编码头部。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [ "Width", "Height" ] }, { "name": "DeleteImages", "description": "删除图片。 \u003e - 可前往 [图像搜索](https://cloud.tencent.com/document/product/1589) 产品文档中查看更多产品信息。", "status": "online", "parameters": [ { "name": "GroupId", "type": "string", "required": true, "description": "图库名称。", "example": "test_group" }, { "name": "EntityId", "type": "string", "required": true, "description": "物品ID。", "example": "4170" }, { "name": "PicName", "type": "string", "required": false, "description": "图片名称，如果不指定本参数，则删除EntityId下所有的图片；否则删除指定的图。", "example": "my_pic" } ], "required": [ "GroupId", "EntityId" ] }, { "name": "DescribeGroups", "description": "查询所有的图库信息。 \u003e - 可前往 [图像搜索](https://cloud.tencent.com/document/product/1589) 产品文档中查看更多产品信息。", "status": "online", "parameters": [ { "name": "Offset", "type": "integer", "required": false, "description": "起始序号，默认值为0。", "example": "0" }, { "name": "Limit", "type": "integer", "required": false, "description": "返回数量，默认值为10，最大值为100。", "example": "10" }, { "name": "GroupId", "type": "string", "required": false, "description": "图库ID，如果不为空，则返回指定库信息。", "example": "test_group" } ], "required": [] }, { "name": "DescribeImages", "description": "获取指定图片库中的图片列表。 \u003e - 可前往 [图像搜索](https://cloud.tencent.com/document/product/1589) 产品文档中查看更多产品信息。", "status": "online", "parameters": [ { "name": "GroupId", "type": "string", "required": true, "description": "图库名称。", "example": "test_group" }, { "name": "EntityId", "type": "string", "required": true, "description": "物品ID。", "example": "test_entity" }, { "name": "PicName", "type": "string", "required": false, "description": "图片名称。", "example": "pic_name" } ], "required": [ "GroupId", "EntityId" ] }, { "name": "DetectChefDress", "description": "可对图片中厨师穿戴进行识别，支持厨师服识别，厨师帽识别，赤膊识别和口罩识别,可应用于明厨亮灶场景。 \"被优选过滤\"标签值在人体优选开关开启时才会返回。 厨师服：厨师服定义为白色上衣 厨师服识别(酒店版)：厨师服定义为红色，白色，黑色上衣 |序号 | 标签名称 | 标签值 | | :-----| :---------- |:----------------- | | 1 | 厨师服识别 |无厨师服、有厨师服、被优选过滤| | 2 | 厨\ufffd...", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片的 Url 。 ImageUrl和ImageBase64必须提供一个，同时存在时优先使用ImageUrl字段。 图片限制： • 图片格式：支持PNG、JPG、JPEG、不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过 3840 x 2160pixel。 建议： • 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 注意：图片需要base64编码，并且要去掉编码头部。 支持的图片格式：PNG、JPG、JPEG、暂不支持GIF格式。 支持的图片大小：所下载图片经Base64编码后不超过5M。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" }, { "name": "EnableDetect", "type": "boolean", "required": false, "description": "人体检测模型开关，“true”为开启，“false”为关闭 默认为开启，开启后可先对图片中的人体进行检测之后再进行属性识别", "example": "true" }, { "name": "EnablePreferred", "type": "boolean", "required": false, "description": "人体优选开关，“true”为开启，“false”为关闭 开启后自动对检测质量低的人体进行优选过滤，有助于提高属性识别的准确率。 默认为开启，仅在人体检测开关开启时可配置，人体检测模型关闭时人体优选也关闭 人体优选开启时，检测到的人体分辨率不超过1920*1080 pixel", "example": "true" } ], "required": [] }, { "name": "DetectDisgust", "description": "输入一张图片，返回AI针对一张图片是否是恶心的一系列判断值。 通过恶心图片识别, 可以判断一张图片是否令人恶心, 同时给出它属于的潜在类别, 让您能够过滤掉使人不愉快的图片。 \u003e - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边：短边\u003c5； 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 **注意：图片需要base64编码，并且要去掉编码头部。**", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "DetectEnvelope", "description": "文件封识别可检测图片中是否包含符合文件封（即文件、单据、资料等的袋状包装）特征的物品，覆盖顺丰快递文件封、文件袋、档案袋等多种文件封类型，可应用于物流行业对文件快递的包装审核等场景。 \u003e? - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片的URL地址。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 图片大小的限制为4M，图片像素的限制为4k。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 图片大小的限制为4M，图片像素的限制为4k。 **注意：图片需要base64编码，并且要去掉编码头部。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "DetectLabel", "description": "图像标签利用深度学习技术，可以对图片进行智能分类、物体识别等。 目前支持八个大类、六十多个子类、数千个标签，涵盖各种日常场景、动植物、物品、美食等。 图像标签提供四个版本供选择： • 摄像头版：针对搜索、手机摄像头照片进行优化，涵盖大量卡证、日常物品、二维码条形码。 • 相册版：针对手机相册、网盘进行优化，去除相册和网盘中不常见的标签，针\ufffd\ufffd...", "status": "online", "parameters": [ { "name": "ImageBase64", "type": "string", "required": false, "description": "图片 Base64 编码数据。 与ImageUrl同时存在时优先使用ImageUrl字段。 图片限制： • 图片格式：PNG、JPG、JPEG、BMP。 • 图片大小：经Base64编码后不超过4M。 **注意：图片需要Base64编码，并且要去掉编码头部。**", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" }, { "name": "ImageUrl", "type": "string", "required": false, "description": "图片 URL 地址。 图片限制： • 图片格式：PNG、JPG、JPEG、BMP。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边:短边\u003c5； • 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "Scenes", "type": "array", "required": false, "description": "本次调用支持的识别场景，可选值如下： • WEB，针对网络图片优化; • CAMERA，针对手机摄像头拍摄图片优化; • ALBUM，针对手机相册、网盘产品优化; • NEWS，针对新闻、资讯、广电等行业优化； 如果不传此参数，则默认为WEB。 支持多场景（Scenes）一起检测。例如，使用 Scenes=[\"WEB\", \"CAMERA\"]，即对一张图片使用两个模型同时检测，输出两套识别结果。", "example": "[\"WEB\",\"CAMERA\",\"ALBUM\"]", "item_type": "string" } ], "required": [] }, { "name": "DetectLabelPro", "description": "通用图像标签可识别数千种常见物体或场景，覆盖日常物品、场景、动物、植物、食物、饮品、交通工具等多个大类，返回主体的标签名称和所属细分类目等。 \u003e - 可前往 [图像标签](https://cloud.tencent.com/document/product/1588) 产品文档中查看更多产品信息。 - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片 URL 地址。 图片限制： • 图片格式：PNG、JPG、JPEG、BMP。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边:短边\u003c5； • 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片 Base64 编码数据。 与ImageUrl同时存在时优先使用ImageUrl字段。 图片限制： • 图片格式：PNG、JPG、JPEG、BMP。 • 图片大小：经Base64编码后不超过4M。 **注意：图片需要Base64编码，并且要去掉编码头部。**", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "DetectMisbehavior", "description": "可以识别输入的图片中是否包含不良行为，例如打架斗殴、赌博、抽烟等，可以应用于广告图、直播截图、短视频截图等审核，减少不良行为对平台内容质量的影响，维护健康向上的互联网环境。 \u003e - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边：短边\u003c5； 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 **注意：图片需要base64编码，并且要去掉编码头部。**", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "DetectPet", "description": "传入一张图片，识别出图片中是否存在宠物 \u003e - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片的URL地址。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 图片大小的限制为4M，图片像素的限制为4k。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。与ImageUrl同时存在时优先使用ImageUrl字段。 图片大小的限制为4M，图片像素的限制为4k。 **注意：图片需要base64编码，并且要去掉编码头部。**", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "DetectProduct", "description": "本接口支持识别图片中包含的商品，能够输出商品的品类名称、类别，还可以输出商品在图片中的位置。支持一张图片多个商品的识别。 \u003e? - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边：短边\u003c5； 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 **注意：图片需要base64编码，并且要去掉编码头部。**", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "DetectSecurity", "description": "安全属性识别可对图片中人体安全防护属性进行识别，支持识别安全帽，反光衣，护目镜，工服，手套，工地安全带，口罩，抽烟，玩手机等多种属性。 \"被优选过滤\"标签值在人体优选开关开启时才会返回。 |序号 | 标签名称 | 标签值 | | :-----| :---------- |:----------------- | | 1 | 安全帽识别 |无安全帽、有安全帽、被优选过滤| | 2 | 玩手机识别 |没有电话、打电话、玩手机、被优选过\ufffd...", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片的 Url 。 ImageUrl和ImageBase64必须提供一个，同时存在时优先使用ImageUrl字段。 图片限制： • 图片格式：支持PNG、JPG、JPEG、不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过3840 x 2160 pixel。 建议： • 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。 最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 注意：图片需要base64编码，并且要去掉编码头部。 支持的图片格式：PNG、JPG、JPEG、暂不支持GIF格式。 支持的图片大小：所下载图片经Base64编码后不超过5M。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" }, { "name": "EnableDetect", "type": "boolean", "required": false, "description": "人体检测模型开关，“true”为开启，“false”为关闭 开启后可先对图片中的人体进行检测之后再进行属性识别，默认为开启", "example": "true" }, { "name": "EnablePreferred", "type": "boolean", "required": false, "description": "人体优选开关，“true”为开启，“false”为关闭 开启后自动对检测质量低的人体进行优选过滤，有助于提高属性识别的准确率。 默认为开启，仅在人体检测开关开启时可配置，人体检测模型关闭时人体优选也关闭 如开启人体优选，检测到的人体分辨率需不大于1920*1080 pixel", "example": "ture" } ], "required": [] }, { "name": "EnhanceImage", "description": "传入一张图片，输出清晰度提升后的图片。 可以消除图片有损压缩导致的噪声，和使用滤镜、拍摄失焦导致的模糊。让图片的边缘和细节更加清晰自然。 \u003e - 可前往 [图像处理](https://cloud.tencent.com/document/product/1590) 产品文档中查看更多产品信息。 - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，最大不超过250万像素，否则影响识别效果。 • 长宽比：长边：短边\u003c5。 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。图片经过Base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 注意：图片需要Base64编码，并且要去掉编码头部。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "RecognizeCar", "description": "车辆识别可对图片中车辆的车型进行识别，输出车辆的品牌（如路虎）、车系（如神行者2）、类型（如中型SUV）、颜色和车辆在图中的坐标等信息，覆盖轿车、SUV、大型客车等市面常见车，支持三千多种车辆型号。如果图片中存在多辆车，会分别输出每辆车的车型和坐标。 \u003e? - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边：短边\u003c5； 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 **注意：图片需要base64编码，并且要去掉编码头部。** 支持的图片格式：PNG、JPG、JPEG、BMP，暂不支持GIF格式。支持的图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "RecognizeCarPro", "description": "车辆识别（增强版）在车辆识别的基础上**增加了车牌识别的功能，并升级了车型识别的效果**。可对图片中车辆的车型和车牌进行同时识别，输出车辆的车牌信息，以及车辆品牌（如路虎）、车系（如神行者2）、类型（如中型SUV）、颜色和车辆在图中的坐标等信息，覆盖轿车、SUV、大型客车等市面常见车，支持三千多种车辆型号。如果图片中存在多辆车，会分别输出每辆车的...", "status": "online", "parameters": [ { "name": "ImageUrl", "type": "string", "required": false, "description": "图片URL地址。 图片限制： • 图片格式：PNG、JPG、JPEG。 • 图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。 建议： • 图片像素：大于50*50像素，否则影响识别效果； • 长宽比：长边：短边\u003c5； 接口响应时间会受到图片下载时间的影响，建议使用更可靠的存储服务，推荐将图片存储在腾讯云COS。", "example": "https://cos.ap-singapore.myqcloud.com/input.png" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片经过base64编码的内容。最大不超过4M。与ImageUrl同时存在时优先使用ImageUrl字段。 **注意：图片需要base64编码，并且要去掉编码头部。** 支持的图片格式：PNG、JPG、JPEG、BMP，暂不支持GIF格式。支持的图片大小：所下载图片经Base64编码后不超过4M。图片下载时间不超过3秒。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" } ], "required": [] }, { "name": "SearchImage", "description": "本接口用于对一张图片，在指定图片库中检索出与之相似的图片列表。 \u003e - 可前往 [图像搜索](https://cloud.tencent.com/document/product/1589) 产品文档中查看更多产品信息。", "status": "online", "parameters": [ { "name": "GroupId", "type": "string", "required": true, "description": "图库名称。", "example": "test_group" }, { "name": "ImageUrl", "type": "string", "required": false, "description": "图片的 Url 。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096\\*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\\*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，\ufffd\ufffd...", "example": "https://liudhu-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg" }, { "name": "ImageBase64", "type": "string", "required": false, "description": "图片 base64 数据。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096\\*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\\*2000，图片长宽比小于10。", "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z" }, { "name": "Limit", "type": "integer", "required": false, "description": "返回结果的数量，默认值为10，最大值为100。 按照相似度分数由高到低排序。 **服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。**", "example": "10" }, { "name": "Offset", "type": "integer", "required": false, "description": "返回结果的起始序号，默认值为0。", "example": "0" }, { "name": "MatchThreshold", "type": "integer", "required": false, "description": "匹配阈值。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低\ufffd...", "example": "0" }, { "name": "Filter", "type": "string", "required": false, "description": "标签过滤条件。 针对创建图片时提交的Tags信息进行条件过滤。支持\u003e、\u003e=、 \u003c、 \u003c=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。", "example": "value \u003e 1" }, { "name": "ImageRect", "type": "object", "required": false, "description": "图像主体区域。 若设置主体区域，提取指定的区域进行检索。", "example": "{\"X\":231,\"Y\":322,\"Width\":\"200\",\"Height\":200}", "children": [ { "name": "X", "type": "integer", "required": true, "description": "左上角横坐标。", "example": "200" }, { "name": "Y", "type": "integer", "required": true, "description": "左上角纵坐标。", "example": "200" }, { "name": "Width", "type": "integer", "required": true, "description": "宽度。", "example": "400" }, { "name": "Height", "type": "integer", "required": true, "description": "高度。", "example": "400" } ] }, { "name": "EnableDetect", "type": "boolean", "required": false, "description": "是否需要启用主体识别，默认为**TRUE** 。 • 为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在**Response中**获取。 • 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图检索图片。 **注意：仅服务类型为商品图像搜索时才生效。**", "example": "true" }, { "name": "CategoryId", "type": "integer", "required": false, "description": "图像类目ID。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 **注意：仅服务类型为商品图像搜索时才生效。**", "example": "1" } ], "required": [ "GroupId" ] }, { "name": "UpdateImage", "description": "本接口支持根据图库ID、物品ID、图片名称来修改图片信息（暂仅支持修改Tags） \u003e - 可前往 [图像搜索](https://cloud.tencent.com/document/product/1589) 产品文档中查看更多产品信息。", "status": "online", "parameters": [ { "name": "GroupId", "type": "string", "required": true, "description": "图库ID。", "example": "test_group" }, { "name": "EntityId", "type": "string", "required": true, "description": "物品ID，最多支持64个字符。", "example": "test_entity" }, { "name": "PicName", "type": "string", "required": false, "description": "图片名称，最多支持64个字符。", "example": "my_pic" }, { "name": "Tags", "type": "string", "required": false, "description": "新的自定义标签，最多不超过10个，格式为JSON。", "example": "{\"flag\":\"1\"}" } ], "required": [ "GroupId", "EntityId" ] } ] }