云服务器内容精选

  • 响应示例 状态码: 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." }
  • 请求示例 “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 }
  • 请求参数 表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。
  • 响应参数 状态码: 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 调用失败时的错误信息。 调用成功时无此字段。