You can call Image Search API operations by sending URL-based HTTP or HTTPS requests. Each URL must include request parameters. This topic describes the syntax of HTTP or HTTPS requests and provides the endpoints of Image Search.


Region Region Public endpoint VPC endpoint
China (Shanghai) cn-shanghai
Singapore (Singapore) ap-southeast-1
China (Hong Kong) cn-hongkong
Japan (Tokyo) ap-northeast-1
Germany (Frankfurt) eu-central-1
  • You can select only the China (Shanghai) region on the China site (
  • You can use a virtual private cloud (VPC) endpoint to call the Image Search API from ECS instances in the same VPC.
  • If you use a VPC endpoint to call the Image Search API, you do not have to consume public bandwidth. For more information, see Use VPC endpoints to call the Image Search API.

Communication protocols

You can send requests over HTTP or HTTPS. We recommend that you send requests over HTTPS for enhanced security.


You can send HTTP POST requests.

Request parameters

Make sure that all the requests contain common request parameters and operation-specific request parameters.

Character encoding

All requests and responses are encoded in UTF-8.

Use VPC endpoints to call the Image Search API

# Use a VPC endpoint
authConfig.endpoint = "";
# Add a configuration item
authConfig.endpointType = "internal";
SDK earlier than V3:
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", <accessKey>, <accessSecret>);
# Use a VPC endpoint
DefaultProfile.addEndpoint("cn-shanghai", "ImageSearch", "");
this.client = new DefaultAcsClient(profile);