html2image api,图像标签_图像识别 Image_API参考_API_华为云
功能介紹
圖像標(biāo)簽服務(wù)準(zhǔn)確識(shí)別自然圖片中數(shù)百種場(chǎng)景、上千種通用物體及其屬性。讓智能相冊(cè)管理、照片檢索和分類、基于場(chǎng)景內(nèi)容或者物體的廣告推薦等功能更加直觀。使用時(shí)用戶發(fā)送待處理圖片,返回圖片標(biāo)簽內(nèi)容及相應(yīng)置信度。
前提條件在使用圖像標(biāo)簽服務(wù)之前需要您完成服務(wù)申請(qǐng)和認(rèn)證鑒權(quán)。
圖像標(biāo)簽?zāi)J(rèn)API調(diào)用最大并發(fā)為10,如需調(diào)整更高并發(fā)限制請(qǐng)聯(lián)系華為專業(yè)工程師為您服務(wù)。
URI
URI格式
POST /v1.0/image/tagging
請(qǐng)求消息
請(qǐng)求參數(shù)請(qǐng)參見(jiàn)表1。
表1請(qǐng)求參數(shù)說(shuō)明名稱
是否必選
類型
說(shuō)明
image
false
String
與url二選一。
圖像數(shù)據(jù),base64編碼,要求base64編碼后大小不超過(guò)10MB,最短邊至少15px,最長(zhǎng)邊最大4096px,支持JPG、PNG、BMP格式。
url
false
String
與image二選一。
圖片的URL路徑,目前支持:
公網(wǎng)HTTP/HTTPS URL
OBS提供的URL,使用OBS數(shù)據(jù)需要進(jìn)行授權(quán)。包括對(duì)服務(wù)授權(quán)、臨時(shí)授權(quán)、匿名公開(kāi)授權(quán)。詳請(qǐng)參見(jiàn)配置OBS服務(wù)的訪問(wèn)權(quán)限。
說(shuō)明:
接口響應(yīng)時(shí)間依賴于圖片的下載時(shí)間,如果圖片下載時(shí)間過(guò)長(zhǎng),會(huì)返回接口調(diào)用失敗。
請(qǐng)保證被檢測(cè)圖片所在的存儲(chǔ)服務(wù)穩(wěn)定可靠,推薦使用OBS服務(wù)存儲(chǔ)圖片數(shù)據(jù)。
lmage不支持跨區(qū)域OBS,OBS的區(qū)域需要和服務(wù)保持一致。
language
false
String
zh:返回標(biāo)簽的語(yǔ)言類型為中文。
en:返回標(biāo)簽的語(yǔ)言類型為英文。
默認(rèn)值為zh。
limit
false
Integer
最多返回的標(biāo)簽數(shù),默認(rèn)值:30。
threshold
false
Float
置信度的閾值(0~100),輸入非該范圍內(nèi)值算法即取默認(rèn)值。
默認(rèn)值:0。
響應(yīng)消息
響應(yīng)參數(shù)請(qǐng)參見(jiàn)表2。
表2響應(yīng)參數(shù)說(shuō)明名稱
類型
說(shuō)明
result
JSON
調(diào)用成功時(shí)為圖片標(biāo)簽內(nèi)容。
調(diào)用失敗時(shí)無(wú)此字段。
tags
List
標(biāo)簽列表集合。
confidence
Float
置信度,取值范圍(0~100)。
tag
String
標(biāo)簽名稱。
type
String
標(biāo)簽的類別。有以下三種類別:
object:實(shí)體標(biāo)簽
scene:場(chǎng)景標(biāo)簽
concept:概念標(biāo)簽
i18n_tag
JSON
標(biāo)簽的國(guó)際化字段。(i18n只是個(gè)國(guó)際化標(biāo)志,無(wú)特殊含義)。
zh:中文
en:英文
error_code
String
調(diào)用失敗時(shí)的錯(cuò)誤碼,具體請(qǐng)參見(jiàn)錯(cuò)誤碼。
調(diào)用成功時(shí)無(wú)此字段。
error_msg
String
調(diào)用失敗時(shí)的錯(cuò)誤信息。
調(diào)用成功時(shí)無(wú)此字段。
示例請(qǐng)求示例(方式一:使用圖片的BASE64編碼)POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/tagging
Request Header:
Content-Type:application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
Request Body:
{
"image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
"url": "",
"language": "en",
"limit": 5,
"threshold": 60.0
}
請(qǐng)求示例(方式二:使用圖片URL)POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/tagging
Request Header:
Content-Type:application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
Request Body:
{
"image":"",
"url":"https://.obs..myhuaweicloud.com/",
"language": "en",
"limit": 5,
"threshold": 60.0
}
成功響應(yīng)示例{
"result":{
"tags":[
{
"confidence": 38.51,
"tag":"sky",
"i18n_tag":
{
"en": "sky",
"zh": "天空"
},
"type": "object"
},
{
"confidence": 25.75,
"tag":"landscape",
"i18n_tag":
{
"en": "landscape",
"zh": "風(fēng)景"
},
"type": "scene"
}
]
}
}
失敗響應(yīng)示例{
"error_code": "AIS.0014",
"error_msg": "The JSON format of the input data is incorrect."
}
返回值正常
200
失敗
返回值
說(shuō)明
400
語(yǔ)義有誤,當(dāng)前請(qǐng)求無(wú)法被服務(wù)器解析。除非進(jìn)行修改,否則客戶端不應(yīng)重復(fù)提交這個(gè)請(qǐng)求。
請(qǐng)求參數(shù)有誤。
401
當(dāng)前請(qǐng)求需要用戶驗(yàn)證。
403
沒(méi)有操作權(quán)限。
404
請(qǐng)求失敗,在服務(wù)器上未找到請(qǐng)求所希望得到的資源。
500
服務(wù)器遇到了一個(gè)未曾預(yù)料的狀況,導(dǎo)致無(wú)法完成對(duì)請(qǐng)求的處理。
錯(cuò)誤碼
錯(cuò)誤碼請(qǐng)參見(jiàn) 錯(cuò)誤碼。
總結(jié)
以上是生活随笔為你收集整理的html2image api,图像标签_图像识别 Image_API参考_API_华为云的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: html5 video全屏api,H5+
- 下一篇: 对口单招考试能用计算机吗,对口单招计算机