功能介紹

圖像標(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)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。