集成概覽
視覺(jué)智能開(kāi)發(fā)平臺(tái)提供可視化操作控制臺(tái)，還提供OpenAPI在線調(diào)試、阿里云SDK等調(diào)用方式。為提升您使用視覺(jué)智能開(kāi)發(fā)平臺(tái)的開(kāi)發(fā)效率，建議您按需選擇合適的操作和集成方式。
OpenAPI介紹
為了能夠讓開(kāi)發(fā)者快速高效的學(xué)習(xí)和使用云產(chǎn)品OpenAPI，阿里云為用戶(hù)提供OpenAPI網(wǎng)站。它是一款集OpenAPI智能搜索、文檔、在線調(diào)試、SDK獲取、CodeSample、調(diào)用出錯(cuò)診斷、調(diào)用統(tǒng)計(jì)為一體的產(chǎn)品。您可以在OpenAPI門(mén)戶(hù)中調(diào)用阿里云各云產(chǎn)品開(kāi)放的OpenAPI，查看OpenAPI請(qǐng)求和返回結(jié)果。此外，OpenAPI門(mén)戶(hù)會(huì)自動(dòng)生成相應(yīng)的SDK調(diào)用示例，幫助您快速使用阿里云產(chǎn)品。更多信息，請(qǐng)參見(jiàn)什么是OpenAPI。
版本說(shuō)明
阿里云OpenAPI通過(guò)版本號(hào)管控各時(shí)期云產(chǎn)品大版本的API列表，例如視覺(jué)智能開(kāi)發(fā)平臺(tái)目前支持2024-01-11版本的API列表，2024-01-11代表的是API版本號(hào)而非時(shí)間概念，所展示的都是最新的API公開(kāi)數(shù)據(jù)，并非自2024-01-11之后就未更新。
版本號(hào) | 說(shuō)明 |
2024-01-11（API概覽） | 推薦使用 |
在線調(diào)試
視覺(jué)智能開(kāi)發(fā)平臺(tái)在OpenAPI門(mén)戶(hù)提供API調(diào)試等功能。在調(diào)用前，您需要了視覺(jué)智能開(kāi)發(fā)平臺(tái)提供的版本、接入點(diǎn)說(shuō)明、集成方式等信息。
調(diào)試入口
調(diào)試API入口為：https://next.api.aliyun.com/api/facebody/2019-12-30/AddFaceEntity
接入點(diǎn)說(shuō)明
根據(jù)相關(guān)資源所在地域，選擇對(duì)應(yīng)的服務(wù)接入點(diǎn)地址，以獲得最低延遲。例如文字識(shí)別的華東2（上海）的公網(wǎng)接入地址為ocr.cn-shanghai.aliyuncs.com，VPC接入地址為ocr-vpc.cn-shanghai.aliyuncs.com。
公網(wǎng)接入地址全球都可訪問(wèn)。
VPC接入地址只有在阿里云對(duì)應(yīng)的地域內(nèi)，且是VPC網(wǎng)絡(luò)類(lèi)型才可訪問(wèn)。VPC地址的優(yōu)勢(shì)：
高安全性：VPC服務(wù)地址只能在VPC內(nèi)部訪問(wèn)，提供更高的安全性和隱私性。
更快的響應(yīng)速度：由于VPC服務(wù)地址在VPC內(nèi)部網(wǎng)絡(luò)中運(yùn)行，其響應(yīng)速度通常比公網(wǎng)服務(wù)更快，且可以避免公網(wǎng)延遲和帶寬限制等問(wèn)題。
更低的成本：VPC服務(wù)地址可以使用內(nèi)部網(wǎng)絡(luò)通信。
更多信息，請(qǐng)參見(jiàn)訪問(wèn)域名。
支持的用戶(hù)身份
當(dāng)前產(chǎn)品支持通過(guò)如下用戶(hù)身份調(diào)用API。推薦您使用RAM用戶(hù)或RAM角色，根據(jù)業(yè)務(wù)的實(shí)際情況按需分配權(quán)限后進(jìn)行接口調(diào)用。
您用阿里云賬號(hào)登錄OpenAPI網(wǎng)站后，OpenAPI默認(rèn)使用您的阿里云賬號(hào)進(jìn)行在線OpenAPI調(diào)試。阿里云賬號(hào)擁有所有API的訪問(wèn)權(quán)限，風(fēng)險(xiǎn)很高。強(qiáng)烈建議您創(chuàng)建并使用RAM用戶(hù)進(jìn)行API訪問(wèn)或日常運(yùn)維。請(qǐng)根據(jù)業(yè)務(wù)的實(shí)際情況按需分配權(quán)限后進(jìn)行接口調(diào)用。RAM用戶(hù)需具備操作視覺(jué)智能開(kāi)發(fā)平臺(tái)資源的權(quán)限。具體操作，請(qǐng)參見(jiàn)創(chuàng)建RAM用戶(hù)進(jìn)行視覺(jué)智能開(kāi)發(fā)平臺(tái)操作。
用戶(hù)身份 | 支持情況 |
支持 | |
RAM用戶(hù)（推薦） | 支持 |
RAM角色（推薦） | 支持 |
更多信息
集成方式
SDK是最易于集成，且支持度最好的OpenAPI調(diào)用方式，推薦您選擇使用SDK。
阿里云 SDK
阿里云為開(kāi)發(fā)者提供了多種編程語(yǔ)言（Java、C#、Go、Python、Node.js/TypeScript、PHP、C++ 等）的SDK。開(kāi)發(fā)者只需要集成SDK，通過(guò)SDK暴露的方法直接調(diào)用OpenAPI。SDK統(tǒng)一封裝了簽名邏輯、超時(shí)機(jī)制、重試機(jī)制，并根據(jù)文檔返回結(jié)構(gòu)化Response對(duì)象，易于開(kāi)發(fā)。更多關(guān)于阿里云SDK的介紹，請(qǐng)參見(jiàn)阿里云SDK。
支持在OpenAPI通過(guò)阿里云SDK調(diào)用視覺(jué)智能開(kāi)發(fā)平臺(tái)。支持語(yǔ)言及依賴(lài)安裝方法請(qǐng)參見(jiàn)下列。
自定義封裝API調(diào)用
原生HTTP調(diào)用需要您自己實(shí)現(xiàn)簽名算法，并構(gòu)建自定義請(qǐng)求，發(fā)起HTTP調(diào)用。有關(guān)簽名機(jī)制的更多詳細(xì)信息，請(qǐng)參見(jiàn)API概覽和請(qǐng)求簽名。
注意事項(xiàng)
如果調(diào)用視覺(jué)智能開(kāi)發(fā)平臺(tái)API后返回錯(cuò)誤，您需要根據(jù)返回的錯(cuò)誤碼提示檢查傳入的請(qǐng)求參數(shù)及其取值是否正確。更多信息，請(qǐng)參見(jiàn)API參考下各個(gè)專(zhuān)項(xiàng)內(nèi)部的常見(jiàn)錯(cuò)誤碼。例如，目標(biāo)檢測(cè)下的目標(biāo)檢測(cè)常見(jiàn)錯(cuò)誤碼。
您也可以記錄下調(diào)用返回的RequestID或SDK報(bào)錯(cuò)信息，通過(guò)阿里云OpenAPI診斷平臺(tái)進(jìn)行自助診斷。
常見(jiàn)問(wèn)題
如果您想了解阿里云視覺(jué)智能開(kāi)放平臺(tái)產(chǎn)品，請(qǐng)參見(jiàn)什么是阿里云視覺(jué)智能開(kāi)放平臺(tái)。
阿里云視覺(jué)智能開(kāi)放平臺(tái)為您提供普惠易用的AI能力，將圍繞多個(gè)視覺(jué)領(lǐng)域，例如：通用、圖像、視頻以及目標(biāo)識(shí)別等類(lèi)目，持續(xù)為您提供多種視覺(jué)AI能力。具體方向包括：創(chuàng)新專(zhuān)區(qū)介紹、人臉人體介紹、文字識(shí)別介紹、商品理解介紹、內(nèi)容審核介紹、圖像識(shí)別介紹、圖像生產(chǎn)介紹、分割摳圖介紹、視覺(jué)搜索介紹、圖像分析處理介紹、目標(biāo)檢測(cè)介紹、視頻理解介紹、視頻生產(chǎn)介紹、視頻分割介紹共14個(gè)類(lèi)目，上百項(xiàng)AI能力供您使用。平臺(tái)將持續(xù)更新迭代更多視覺(jué)AI能力，所有能力均通過(guò)API方式提供，為您提供通用且標(biāo)準(zhǔn)化的接入方式，方便您快速接入及使用。更多信息，請(qǐng)您持續(xù)關(guān)注阿里云視覺(jué)智能開(kāi)放平臺(tái)。
除了Java SDK，還支持C#、Go、Python、Node.js/TypeScript、PHP、C++等，更多信息，請(qǐng)參見(jiàn)SDK參考。