菜单

一键新机

使用说明

一键新机，支持更换代理ID，支持指定手机型号

此接口需要在云手机开机状态下才能使用

请求说明

POST /api/v1/cloudPhone/newPhone

请求参数

参数	类型	必需	说明
image_id	string	是	云手机ID
proxy_id	string	否	可指定代理ID，代理ID可通过代理列表接口获取
dns	integer	否	dns开启状态，1开启；2关闭，默认开启
model	string	否	可指定手机型号，具体Android版本支持的型号可通过手机型号接口获取
gps	Object	否	GPS定位
locale	Object	否	本地化
sim	Object	否	SIM卡
data_type	integer	否	1重装系统; 2清理应用数据; 3保留应用数据，默认重装系统
dpi_name	string	否	分辨率，具体值请查看本文的附表1
network_mode	integer	否	1 wifi; 2 移动数据，默认wifi，Android 10/Android 11/Android 12(区域B) 的云手机只支持 Wi-Fi 联网
keep_gp	integer	否	0: 清除Google Play；1：保留Google Play,默认0

gps

参数	类型	必需	说明
type	integer	是	1基于代理IP仿真；2自定义，默认基于代理IP仿真
longitude	string	否	经度，若type为1此值不生效
latitude	string	否	纬度，若type为1此值不生效

locale

参数	类型	必需	说明
type	integer	否	1基于代理IP仿真；2自定义，默认基于代理IP仿真
timezone	string	否	时区，若type为1此值不生效，支持的时区可通过时区列表接口获取
language	string	否	语言，若type为1此值不生效，未设置时默认基于IP仿真，可通过语言列表接口获取语言编码

sim

参数	类型	必需	说明
type	integer	否	类型，1 基于代理IP仿真；2 自定义地区；3 关闭；4 自定义号码； 5 云号码，默认基于代理IP仿真
country	string	否	国家，当type为2时必传，必须符合 ISO 3166-1 alpha-2 格式，完整的国家代码列表可通过 ISO 3166 国家代码列表获取
phone_number	string	否	完整的电话号码，+开头，当type为4、5时必传

注意：使用自定义手机号码（不支持 +86 号码）存在风控风险，IMSI、ICCIDD、运营商信息等信息匹配好，请谨慎使用！

附表1 - 支持的分辨率

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

请求示例

json 复制代码

{
    "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"
    }
}

返回示例

json 复制代码

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

上一个

语言列表

下一个

批量设置Root权限

最近修改: 2026-10-14Powered by

大纲