云服务器内容精选
-
终端节点 终端节点即调用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 调用失败时的错误信息。 调用成功时无此字段。
更多精彩内容
CDN加速
GaussDB
文字转换成语音
免费的服务器
如何创建网站
域名网站购买
私有云桌面
云主机哪个好
域名怎么备案
手机云电脑
SSL证书申请
云点播服务器
免费OCR是什么
电脑云桌面
域名备案怎么弄
语音转文字
文字图片识别
云桌面是什么
网址安全检测
网站建设搭建
国外CDN加速
SSL免费证书申请
短信批量发送
图片OCR识别
云数据库MySQL
个人域名购买
录音转文字
扫描图片识别文字
OCR图片识别
行驶证识别
虚拟电话号码
电话呼叫中心软件
怎么制作一个网站
Email注册网站
华为VNC
图像文字识别
企业网站制作
个人网站搭建
华为云计算
免费租用云托管
云桌面云服务器
ocr文字识别免费版
HTTPS证书申请
图片文字识别转换
国外域名注册商
使用免费虚拟主机
云电脑主机多少钱
鲲鹏云手机
短信验证码平台
OCR图片文字识别
SSL证书是什么
申请企业邮箱步骤
免费的企业用邮箱
云免流搭建教程
域名价格