阿里云圖像搜索API支持基于URL發起HTTP/HTTPS請求。請求參數需要包含在URL中。本文列舉了API請求中的結構解釋,并提供了圖像搜索服務的接入地址(Endpoint)。
如需了解更多產品詳情和獲取技術支持,請單擊在線咨詢或通過釘釘群(35035130)聯系我們。
服務地址
地域 | Region | 接入地址 | VPC內網地址 |
華東1 (杭州) | cn-hangzhou | imagesearch.cn-hangzhou.aliyuncs.com | imagesearch-vpc.cn-hangzhou.aliyuncs.com |
華東2(上海) | cn-shanghai | imagesearch.cn-shanghai.aliyuncs.com | imagesearch-vpc.cn-shanghai.aliyuncs.com |
華北2(北京) | cn-beijing | imagesearch.cn-beijing.aliyuncs.com | imagesearch-vpc.cn-beijing.aliyuncs.com |
華南1(深圳) | cn-shenzhen | imagesearch.cn-shenzhen.aliyuncs.com | imagesearch-vpc.cn-shenzhen.aliyuncs.com |
亞太東南 1 (新加坡) | ap-southeast-1 | imagesearch.ap-southeast-1.aliyuncs.com | imagesearch-vpc.ap-southeast-1.aliyuncs.com |
中國(香港) | cn-hongkong | imagesearch.cn-hongkong.aliyuncs.com | imagesearch-vpc.cn-hongkong.aliyuncs.com |
亞太東北1(東京) | ap-northeast-1 | imagesearch.ap-northeast-1.aliyuncs.com | imagesearch-vpc.ap-northeast-1.aliyuncs.com |
歐洲中部1(法蘭克福) | eu-central-1 | imagesearch.eu-central-1.aliyuncs.com | imagesearch-vpc.eu-central-1.aliyuncs.com |
當前中國站賬號在控制臺中只支持選擇華東2(上海)、華東1(杭州)、華南1(深圳)、華北2(北京)。
VPC內網訪問:僅限同區域ECS上的訪問,例如您購買的圖像搜索實例是華東1(杭州),那么您的ECS或資源也必須在華東1(杭州)才能通過內網VPC地址訪問圖搜服務,否則會調用不通。
VPC內網地址:使用內網服務入口訪問時不會消耗ECS公網流量,幫助您節約ECS公網帶寬資源。詳情請參見VPC使用示例。
通信協議
支持通過HTTP或HTTPS通道進行請求通信。為了獲得更高的安全性,推薦您使用HTTPS通道發送請求。
請求方法
支持HTTP/POST方法發送請求。
請求參數
每個操作都需要包含公共請求Header參數,以及各操作所特有的請求參數。
字符編碼
請求及返回結果都使用UTF-8
字符集進行編碼。
VPC使用示例
v3版本SDK:
# 使用vpc域名
authConfig.endpoint = "imagesearch-vpc.cn-shanghai.aliyuncs.com";
# 新增配置
authConfig.endpointType = "internal";
Java SDK 調用示例請參考Add接口
VPC內網訪問:僅限同區域ECS或資源的訪問,例如您購買的圖像搜索實例是華東1(杭州),那么您的ECS或資源也必須在華東1(杭州)才能通過內網VPC地址訪問圖搜服務,否則會調用不通。
v3之前版本SDK:
// 阿里云賬號AccessKey擁有所有API的訪問權限,建議您使用RAM用戶進行API訪問或日常運維。
// 強烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導致AccessKey泄露,威脅您賬號下所有資源的安全。
// 本示例以將AccessKey ID和AccessKey Secret保存在環境變量為例說明。您也可以根據業務需要,保存到配置文件里。
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", System.getenv("CC_AK_ENV"), System.getenv("CC_SK_ENV"));
// 使用vpc域名
DefaultProfile.addEndpoint("cn-shanghai", "ImageSearch", "imagesearch-vpc.cn-shanghai.aliyuncs.com");
this.client = new DefaultAcsClient(profile);