阿里云图像搜索API支持基于URL发起HTTP/HTTPS请求。请求参数需要包含在URL中。本文列举了API请求中的结构解释,并提供了图像搜索服务的接入地址(Endpoint)。
服务地址
地域 | 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);