Proxy Initialization

Usage Instructions

Initialize the proxy

Request Instructions

POST /api/v1/cloudPhone/initProxy

Request Parameters

Parameter	Type	Required	Description
images	array	Yes

images

Parameter	Type	Required	Description
image_id	string	Yes	Cloud phone ID
name	string	No	Cloud phone name
ip_scan_channel	string	Yes	IP Checker. Currently supported: ip2location, ipapi
proxy	Object	Yes	Proxy
dpi_name	string	No	Resolution. For specific values, please refer to Appendix 1 of this document
network_mode	string	No	Network mode: 1 for Wi-Fi; 2 for Mobile Network. Cloud phones (Android 10/Android 11/Android 12(Region B)) only support Wi-Fi connectivity
brand	string	No	Brand. If not set, a random brand is assigned by default. For brands supported by specific Android versions, please refer to the Model List
model	string	No	Phone model. If not set, a random model is assigned by default. For models supported by specific Android versions, please refer to the Model List
location	Object	No	Location. If not set, simulation is based on the IP by default
sim	Object	No	SIM. If not set, simulation is based on the proxy IP by default
locale	Object	No	Timezone and language. If not set, simulation is based on the proxy IP by default

proxy

Parameter	Type	Required	Description
id	string	No	Proxy ID, can be obtained from the Proxy List
host	string	No	IP address or domain name. Required when Proxy ID is not provided
port	integer	No	Port. Required when Proxy ID is not provided
user	string	No	Username. Only supports uppercase/lowercase letters, numbers, and the following special characters: !@#$%^&*();:.,/~+-_?<>[]=
password	string	No	Password. Only supports uppercase/lowercase letters, numbers, and the following special characters: !@#$%^&*();:.,/~+-_?<>[]=

location

Parameter	Type	Required	Description
longitude	integer	是	Longitude. Range：-180 ~ 180
latitude	integer	是	Latitude. Range：-90 ~ 90

sim

Parameter	Type	Required	Description
type	integer	是	Type: 1 for Simulation based on proxy IP; 2 for Custom region; 3 for Disabled; 4 for Custom number; 5 for Cloud number. Default: Simulation based on proxy IP
country	string	否	Country. Required when type is 2. Must conform to the ISO 3166-1 alpha-2 format. For a complete list of country codes, please refer to the ISO 3166 Country Codes List
phone_number	st ring	否	Full phone number, starting with +. Required when type is 4 or 5

Note: Using a custom mobile number (+86 numbers are not supported) carries risk control risks. Please ensure that IMSI, ICCIDD, and carrier information are properly matched before use!

locale

参数	类型	必需	说明
country	string	是	Region. Must conform to the ISO 3166-1 alpha-2 format. For a complete list of country codes, please refer to the ISO 3166 Country Codes List
timezone	string	是	Timezone. For supported timezones, please refer to the Timezone List
language	integer	否	Language. If not set, simulation is based on the IP by default. For language codes, please refer to the Language List

Appendix 1 - Supported Resolutions

720x1280(320dpi)	720x1600(320dpi)
1080x1920(480dpi)	1080x1920(320dpi)
1080x2040(480dpi)	1080x2040(320dpi)
1080x2160(480dpi)	1080x2160(320dpi)
1080x2280(480dpi)	1080x2280(320dpi)
1080x2340(480dpi)	1080x2340(320dpi)

Request Example

json Copy

{
    "images": [
        {
            "image_id": "xxx",
            "name": "xxx",
            "ip_scan_channel": "ip2location",
            "proxy": {
                "protocol": "socks5",
                "host": "xx.xx.xx.xx",
                "port": "xxxx",
                "user": "xxx",
                "password": "xxx"
            },
            "dpi_name": "720x1600(320dpi)",
            "network_mode": 2,
            "brand": "samsung",
            "model": "SM-A025F",
            "location": {
                "longitude": "xxx",
                "latitude": "xxx"
            },
            "sim": {
                "type": 2,
                "country": "GB"
            },
            "locale": {
                "country": "GB",
                "timezone": "Europe/London",
                "language": "en-GB"
            }
        },
        {
            "image_id": "xxx",
            "ip_scan_channel": "ip2location",
            "proxy": {
                "id": "xxx"
            }
        }
    ]
}

Response Example

json Copy

{
    "code": 200,
    "data": {
        "message": "Success"
    },
    "message": "Success"
}

Batch Modify Parameters

Timezone List

Last modified: 2026-04-09Powered by

Outline