Reset and Regenerate Device

Usage Instructions

Reset and regenerate device, supports changing proxy ID and specifying phone model.

This interface can only be used while the cloud phone is powered on.

Request Instructions

Method: POST
Endpoint: /api/v1/cloudPhone/newPhone

Request Parameters

Parameter	Type	Required	Description
image_id	string	Yes	Cloud phone ID
proxy_id	string	No	Optional proxy ID, can be found in the Proxy List
dns	integer	No	DNS Status: 1 - Enabled; 2 - Disabled. Default is Enabled
model	string	No	Optional phone model, supported models for specific Android versions can be found in the Cloud Phone Model List
gps	Object	No	GPS
locale	Object	No	Timezone and language. If not set, simulation is based on the proxy IP by default
sim	Object	No	SIM. If not set, simulation is based on the proxy IP by default
data_type	integer	否	1 - Reinstall System; 2 - Clear APP Data; 3 - Clear APP Data.Default is Reinstall System
dpi_name	string	否	Resolution. For specific values, please refer to Appendix 1 of this document
network_mode	integer	否	1 WI-FI; 2 Mobile Network，Default is WI-FI. Cloud phones (Android 10/Android 11/Android 12(Region B)) only support Wi-Fi connectivity
keep_gp	integer	No	0: Clear Google Play; 1: Keep Google Play, default is 0

gps

Parameter	Type	Required	Description
type	integer	Yes	1 - Simulate based on proxy IP; 2 - Custom. Default is Simulate based on proxy IP
longitude	string	No	Longitude, If type is 1, this value does not take effect.
latitude	string	No	Latitude, If type is 1, this value does not take effect.

locale

Parameter	Type	Required	Description
type	integer	No	1 - Simulate based on proxy IP; 2 - Custom. Default is Simulate based on proxy IP
timezone	string	No	Timezone, If type is 1, this value does not take effect.For supported timezones, please refer to the Timezone List
language	string	No	Language, If type is 1, this value does not take effect.If not set, simulation is based on the IP by default. For language codes, please refer to the Language List

sim

Parameter	Type	Required	Description
type	integer	No	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	No	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	No	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!

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

{
    "image_id": "xx",
    "proxy_id": "xx",
    "dns": 1,
    "model": "xx",
    "gps": {
        "type": 1,
        "longitude": 88,
        "latitude": 77
    },
    "locale": {
        "type": 1,
        "timezone": "America/Chicago",
        "language": "en-US"
    },
    "sim": {
        "type": 1,
        "country": "US"
    }
}

Response Example

json Copy

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

Cloud Phone Model List

Batch Set Root

Last modified: 2026-10-14Powered by

Outline