媒资图像标签（分类）-华为云

图像识别 IMAGE-标签识别:请求示例

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。例如，服务部署在“华北-北京四”区域的“endpoint”为“image.cn-north-4.myhuaweicloud.com”，请求URL为“https://image.cn-north-4.myhuaweicloud.com/v2/{project_id}/image/media-tagging”，“project_id”为项目ID，获取方法请参见获取项目ID和名称。方式一：使用图片的BASE64编码，对于用户传入的图像返回图像中的物体名称、所属类别及置信度信息，返回标签的语言类型为中文，最多返回的标签数为5。 POST https://{endpoint}/v2/{project_id}/image/media-tagging { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : "", "language" : "zh", "limit" : 5, "threshold" : 20 } 方式二：使用图片URL，对于用户传入的图像返回图像中的物体名称、所属类别及置信度信息，返回标签的语言类型为中文，最多返回的标签数为5。 POST https://{endpoint}/v2/{project_id}/image/media-tagging { "image" : "", "url" : "https://support.huaweicloud.com/productdesc-image/zh-cn_image_0000001382844041.jpg", //此处更改为您需要识别的图片URL "language" : "zh", "limit" : 5, "threshold" : 20 }

图像识别 IMAGE 媒资图像标签（分类）

图像识别 IMAGE-标签识别:响应示例

响应示例状态码： 200 成功响应结果 { "result": { "tags": [ { "confidence": "39.42", "i18n_tag": { "en": "Picnic", "zh": "野餐" }, "i18n_type": { "en": "Food", "zh": "食物" }, "instances": [], "tag": "野餐", "type": "食物" }, { "confidence": "30.19", "i18n_tag": { "en": "Miniature projector", "zh": "微型投影仪" }, "i18n_type": { "en": "Electronics", "zh": "电子类" }, "instances": [], "tag": "微型投影仪", "type": "电子类" }, { "confidence": "24.93", "i18n_tag": { "en": "Picnic Basket", "zh": "野餐篮" }, "i18n_type": { "en": "Home category", "zh": "家居类" }, "instances": [], "tag": "野餐篮", "type": "家居类" }, { "confidence": "21.58", "i18n_tag": { "en": "Harmonica", "zh": "口琴" }, "i18n_type": { "en": "Culture and art", "zh": "文化艺术类" }, "instances": [], "tag": "口琴", "type": "文化艺术类" } ] } } 状态码： 400 失败响应结果 { "error_code" : "AIS.0005", "error_msg" : "The service does not exist." }

图像识别 IMAGE 媒资图像标签（分类）

图像识别 IMAGE-标签识别:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。表3 请求Body参数参数是否必选参数类型描述 image 否 String 与url二选一。图像数据，base64编码，要求base64编码后大小不超过10M，最短边至少1px，最长边最大10000px，支持JPEG/PNG/BMP/WEBP格式。 url 否 String 与image二选一。图片的URL路径，目前支持：公网HTTP/HTTPS URL OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见配置OBS服务的访问权限。说明：接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 lmage不支持跨区域OBS，OBS的区域需要和服务保持一致。 language 否 String zh：返回标签的语言类型为中文。 en：返回标签的语言类型为英文。默认值为zh。 threshold 否 Float 置信度的阈值，取值范围是[0~100]，默认值为40。 limit 否 Integer 最多返回的标签数（最多150个，最少为1个），默认值为10。

图像识别 IMAGE 媒资图像标签（分类）

图像识别 IMAGE-标签识别:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 result result Object 调用成功时为图像标签内容。调用失败时无此字段。表5 result 参数参数类型描述 tags Array of ImageMediaTaggingItemBody Objects 标签列表集合。表6 ImageMediaTaggingItemBody 参数参数类型描述 confidence String 置信度，将Float型置信度转为String类型返回，取值范围：0-100。 type String 标签的类别。返回的标签类型，包含二十多种大类，具体可以参考图像标签分类。 tag String 标签名称。 i18n_tag i18n_tag Object 标签的多种语言输出。 i18n_type i18n_type Object 标签类别的多种语言输出。 instances Array of ImageMediaTaggingInstance Objects 目标检测框信息，该字段为空（为兼容图像标签V2版本保留该字段，可忽略）。表7 i18n_tag 参数参数类型描述 zh String 中文标签。 en String 英文标签。表8 i18n_type 参数参数类型描述 zh String 中文标签类别。 en String 英文标签类别。表9 ImageMediaTaggingInstance 参数参数类型描述 bounding_box BoundingBox Object 目标检测框位置信息。 confidence String 检测标签置信度，将Float型置信度转为String类型返回，Float取值范围（0~100）。表10 BoundingBox 参数参数类型描述 width Integer 检测框区域宽度。 height Integer 检测框区域高度。 top_left_x Integer 检测框左上角到垂直轴距离。 top_left_y Integer 检测框左上角到水平轴距离。状态码： 400 表11 响应Body参数参数参数类型描述 error_code String 调用失败时的错误码，具体请参见错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。

图像识别 IMAGE 媒资图像标签（分类）

云服务器内容精选

媒资图像标签（分类）

7*24

备案

专业服务

退订

建议反馈

售前咨询热线