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