云服务器内容精选

  • 终端节点 终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 图像识别的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 图像识别的终端节点 区 域名 称 区域 终端节点(Endpoint) 华北-北京一 cn-north-1 image.cn-north-1.myhuaweicloud.com 华北-北京四 cn-north-4 image.cn-north-4.myhuaweicloud.com 华东-上海一 cn-east-3 image.cn-east-3.myhuaweicloud.com 父主题: 使用前必读
  • 基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用他们进行日常管理工作。 IAM 用户 由账号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。 在我的凭证下,您可以查看账号ID和用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。 区域(Region) 指云资源所在的物理位置,同一区域内可用区间内网互通,不同区域间内网不互通。通过在不同地区创建云资源,可以将应用程序设计的更接近特定客户的要求,或满足不同地区的法律或其他要求。 可用区(Availability Zone) 一个可用区是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。 父主题: 使用前必读
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的“endpoint”不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“image.cn-north-4.myhuaweicloud.com”,请求URL为“https://image.cn-north-4.myhuaweicloud.com/v2/{project_id}}/image/celebrity-recognition”,“project_id”为项目ID,获取方法请参见获取项目ID和名称。 方式一:使用图片的BASE64编码,识别图中人物,返回人物信息及人脸坐标,置信度的阈值为0.48。 POST https://{endpoint}/v2/{project_id}/image/celebrity-recognition{ "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : "", "threshold" : 0.48} 方式二:使用图片URL,识别图中人物,返回人物信息及人脸坐标,置信度的阈值为0.48。 POST https://{endpoint}/v2/{project_id}/image/celebrity-recognition{ "image" : "", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "threshold" : 0.48}
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见 获取Token 接口,响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 image 否 String 与url二选一 图片文件Base64编码字符串。要求base64编码后大小不超过10M。 检测人脸部分不小于40*40像素。 支持JPEG/PNG/BMP/WEBP格式。 url 否 String 与image二选一。 图片的URL路径,目前支持: 公网HTTP/HTTPS URL 华为云OBS提供的URL,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详情参见配置OBS服务的访问权限。 说明: 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠,建议您使用华为云OBS存储。 threshold 否 Float 置信度的阈值(0~1),低于此置信数的标签,将不会返回。 默认值:0.9。
  • 响应示例 状态码: 200 成功响应结果 { "result" : [ { "confidence" : 0.44977834820747375, "face_detail" : { "h" : 280, "w" : 186, "x" : 163, "y" : 117 }, "label" : "xxx" } ]} 状态码: 400 失败响应结果 { "error_code" : "AIS.0005", "error_msg" : "The service does not exist."}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 result Array of CelebrityRecognitionResultBody objects 调用成功时表示调用结果。 调用失败时无此字段。 表5 CelebrityRecognitionResultBody 参数 参数类型 描述 confidence Float 置信度,取值范围 0-1。 face_detail Object 名人的面部信息,包括4个值: h:人脸区域高度 w:人脸区域宽度 x:人脸区域左上角到y轴距离 y:人脸区域左上角到x轴距离 label String label为对应的名人信息。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 示例 请求示例 POST https://image.cn-north-1.myhuaweicloud.com/v1.0/bgm/recognition Request Header: Content-Type:application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body:{ "url": "https://BucketName.obs.myhuaweicloud.com/ObjectName"} 成功响应示例 { "result": { "audio_name": "my heart will go on" }} 失败响应示例 { "error_code": "AIS.0014", "error_msg": "The JSON format of the input data is incorrect."}
  • 请求示例 “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}
  • 响应参数 状态码: 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 调用失败时的错误信息。 调用成功时无此字段。
  • 响应示例 状态码: 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."}
  • 请求参数 表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。
  • API概览 图像识别服务所提供的API为自研API。通过使用图像识别服务的自研API,您可以完整的使用图像识别服务的如表1所示功能。 表1 接口说明 API 说明 媒资图像标签(分类)-标签识别 标签识别服务使用时,用户发送待处理图片,返回图像标签内容及相应置信度。 媒资图像标签(检测) 对用户传入的图像可以返回图像中物体的坐标位置、物体名称、所属类别及置信度信息。 名人识别 名人识别服务能分析并识别图片中包含的明星及网红人物,返回人物信息及人脸坐标。 主体识别 主体识别服务对用户传入的图片能通过后台算法判断图片主体,并返回主体坐标。 翻拍识别 目前仅支持部分条形码的翻拍识别,可以检测出经过二次处理的不合规范图片,使得统计数据更准确、有效。 图像标签(V2) 图像标签服务 准确识别自然图片中数百种场景、上千种通用物体及其属性,让智能相册管理、照片检索和分类、基于场景内容或者物体的广告推荐等功能更加直观。
  • 请求消息 请求参数请参见表1。 表1 请求参数说明 名称 是否必选 类型 说明 image 与file二选一 String 图片文件BASE64编码字符串。要求base64编码后大小不超过10MB,支持JPEG/PNG/BMP格式。 file 与image二选一 File 图片文件。 scale 否 Integer 放大倍数,默认为3,取值范围:3或4。 model 否 String 图像超分辨率重建采用的算法模式,支持ESPCN和SRCNN,默认ESPCN。 取值为: “ESPCN”:Efficient Sub-Pixel Convolutional Neural Network。 “SRCNN”: Super-Resolution Convolutional Neural Network。
  • 示例 请求示例(方式一:使用图片的BASE64编码) POST https://image.cn-north-1.myhuaweicloud.com/v1.0/vision/super-resolution Request Header: Content-Type:application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body:{ "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...", "scale":3, "model":"ESPCN"} 请求示例(方式二:使用图片文件) POST https://image.cn-north-1.myhuaweicloud.com/v1.0/vision/super-resolution Request Header: X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body(form-data):file:File(图片文件)scale:3model:ESPCN 方式一:图片为BASE64字符串。 成功响应示例 { "result":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj..."} 失败响应示例 { "error_code": "AIS.0105", "error_msg": "Recognize Failed"} 方式二:图片文件类型。 成功响应示例 成功时返回图片文件字节流。 失败响应示例 { "error_code": "AIS.0105", "error_msg": "Recognize Failed"}
  • 响应消息 图片为BASE64字符串响应参数请参见表2。 表2 响应参数说明 名称 类型 说明 result String 调用成功时表示图片文件BASE64字符串。 调用失败时无此字段。 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 图片为文件类型响应参数说明请参见表3。 表3 响应参数说明 名称 类型 说明 error_code String 调用失败时的错误码,具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。