图像标签(v2)-凯发k8国际娱乐官网入口
功能介绍
自然图像的语义内容非常丰富,一个图像包含多个标签内容,图像标签服务准确识别自然图片中数百种场景、上千种通用物体及其属性,让智能相册管理、照片检索和分类、基于场景内容或者物体的广告推荐等功能更加直观。使用时用户发送待处理图片,返回图像标签内容及相应置信度。
前提条件
- 使用图像标签服务之前需要您完成和。
- 图像识别服务属于公有云服务,线上用户资源共享,如果需要多并发请求,请提前。
调试
您可以在中调试该接口,支持自动认证鉴权。api explorer可以自动生成sdk代码示例,并提供sdk代码示例调试功能。
uri
uri格式
post /v2/{project_id}/image/tagging
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
string |
用户的项目id。获取方法请参见。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
x-auth-token |
是 |
string |
用户token。 用于获取操作api的权限。获取方法请参见,响应消息头中x-subject-token的值即为token。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
image |
否 |
string |
与url二选一。 图像数据,base64编码,要求base64编码后大小不超过10m,最短边至少1px,最长边最大4096px,支持jpeg/png/bmp/webp格式。 |
url |
否 |
string |
与image二选一。 图片的url路径,目前支持:
说明:
|
language |
否 |
string |
zh:返回标签的语言类型为中文。 en:返回标签的语言类型为英文。 默认值为zh。 |
threshold |
否 |
float |
置信度的阈值(0~100),低于此置信数的标签,将不会返回。 默认值:60 最小值:0 最大值:100 |
limit |
否 |
integer |
最多返回的tag数(取值范围:1-150)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
result |
result object |
调用成功时为图像标签内容。 调用失败时无此字段。 |
参数 |
参数类型 |
描述 |
---|---|---|
tags |
array of imagetaggingitembody objects |
标签列表集合。 |
参数 |
参数类型 |
描述 |
---|---|---|
confidence |
string |
置信度,将float型置信度转为string类型返回,取值范围:0-100。 |
type |
string |
标签的类别。有以下三种类别: object:实体标签 scene:场景标签 concept:概念标签 |
tag |
string |
标签名称。 |
i18n_tag |
i18n_tag object |
标签的多种语言输出。 |
i18n_type |
i18n_type object |
标签类别的多种语言输出。 |
instances |
array of imagetagginginstance objects |
目标检测框信息,为空则表示没有目标检测框。 |
参数 |
参数类型 |
描述 |
---|---|---|
zh |
string |
中文标签。 |
en |
string |
英文标签。 |
参数 |
参数类型 |
描述 |
---|---|---|
zh |
string |
中文标签类别。 |
en |
string |
英文标签类别。 |
参数 |
参数类型 |
描述 |
---|---|---|
bounding_box |
boundingboxfloat object |
目标检测框位置信息。 |
confidence |
string |
检测标签置信度,将float型置信度转为string类型返回,float取值范围(0~100)。 |
参数 |
参数类型 |
描述 |
---|---|---|
width |
double |
检测框区域宽度。 |
height |
double |
检测框区域高度。 |
top_left_x |
double |
检测框左上角到垂直轴距离。 |
top_left_y |
double |
检测框左上角到水平轴距离。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
string |
调用失败时的错误码,具体请参见。 调用成功时无此字段。 |
error_msg |
string |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
- “endpoint”即调用api的请求地址,不同服务不同区域的“endpoint”不同,具体请参见。
例如,服务部署在“华北-北京四”区域的“endpoint”为“image.cn-north-4.myhuaweicloud.com”,请求url为“https://image.cn-north-4.myhuaweicloud.com/v2/{project_id}}/image/tagging”,“project_id”为项目id,获取方法请参见。
- 方式一:使用图片的base64编码,对待处理图片返回图像标签内容及相应置信度,返回标签的语言类型为中文,置信度的阈值为70。
post https://{endpoint}/v2/{project_id}/image/tagging { "image" : "/9j/4aaqskzjrgabageasabiaad/4rfzrxhpzgaatu0akgaaaagabwesaamaaaabaaeaaaeaaauaaaabaaaaygebaa...", "url" : "", "language" : "zh", "limit" : 5, "threshold" : 70.0 }
- 方式二:使用图片url,对待处理图片返回图像标签内容及相应置信度,返回标签的语言类型为中文,置信度的阈值为70。
post https://{endpoint}/v2/{project_id}/image/tagging { "image" : "", "url" : "https://bucketname.obs.myhuaweicloud.com/objectname", "language" : "zh", "limit" : 5, "threshold" : 70.0 }
响应示例
状态码: 200
成功响应结果
{ "result" : { "tags" : [ { "confidence" : "37.51", "instances" : [ { "confidence" : "92.38", "bounding_box" : { "height" : 133.32496056189905, "top_left_x" : 53.134917332575874, "top_left_y" : 254.21347984900842, "width" : 117.5866567171537 } } ], "tag" : "人", "i18n_tag" : { "en" : "person", "zh" : "人" }, "type" : "人类", "i18n_type" : { "en" : "human", "zh" : "人类" } } ] } }
状态码: 400
失败响应结果
{ "error_code" : "ais.0005", "error_msg" : "the service does not exist." }
状态码
状态码 |
描述 |
---|---|
200 |
成功响应结果。 |
400 |
失败响应结果。 |
错误码
请参见。
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨