菜单

批量修改云机参数

使用说明

批量修改云机参数，最大支持同时开启20台云手机

所有非必需参数，若不传则不修改相应参数值。

请求说明

POST /api/v1/cloudPhone/update

请求参数

参数	类型	必需	说明
images	array	是

images

参数	类型	必需	说明
image_id	string	是	云手机ID
name	string	否	名称
dpi_name	string	否	分辨率
remark	string	否	备注
proxy	Object	否	代理
gps	Object	否	GPS定位
locale	Object	否	本地化
sim	Object	否	SIM卡
bluetooth	Object	否	蓝牙
wifi	Object	否	wifi
device	Object	否	设备信息
station	Object	否	基站信息

proxy

参数	类型	必需	说明
id	string	否	代理ID
dns	integer	否	dns开启状态，1开启；2关闭，默认开启

gps

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

locale

参数	类型	必需	说明
type	integer	否	1基于代理IP仿真；2自定义，默认自定义
timezone	string	否	时区，若type为1此值不生效
language	string	否	语言，若type为1此值不生效

sim

参数	类型	必需	说明
status	integer	否	状态，1开启；2关闭，默认开启
country	string	否	国家
number_id	string	否	云号码ID，通过云号码列表获取，可关联对应的云号码
msisdn	string	否	完整的号码，+开头
operator	string	否	运营服务商
mcc	numeric	否
mnc	numeric	否
msin	numeric	否
iccid	numeric	否
imsi	numeric	否

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

bluetooth

参数	类型	必需	说明
name	string	否	蓝牙名称
address	string	否	蓝牙地址

wifi

参数	类型	必需	说明
status	integer	否	状态，1开启；2关闭，默认开启
name	string	否	wifi名称
mac	string	否
bssid	string	否

device

参数	类型	必需	说明
imei	string	否
serialno	string	否
android_id	string	否
name	string	否	设备名称
gsf_id	string	否
gaid	string	否

注意：gsf_id在Android10和Android11不可直接指定具体值，只要设置一个不为空的值，下次打开会自动重新生成一个新值

station

参数	类型	必需	说明
lac	integer	否	LAC
cid	integer	否	CID

请求示例

json 复制代码

{
    "images": [
      {
        "image_id": "xx",
        "name": "xx",
        "remark": "xx",
        "proxy": {
            "id": "xx",
            "dns": 1
        },
        "gps": {
            "type": 2,
            "longitude": 103.775322,
            "latitude": 1.342415
        },
        "locale": {
            "type": 2,
            "timezone": "America/Chicago",
            "language": "en-US"
        },
        "sim": {
            "status": 1,
            "country": "US",
            "msisdn": "+15056447080",
            "operator": "T-Mobile USA",
            "msin": "661024758",
            "iccid": "8912607766605822130",
            "mcc": "310",
            "mnc": "260",
            "imsi": "310260560389108"
        },
        "bluetooth": {
            "name": "Redmi K30",
            "address": "3d:01:d7:20:fe:28"
        },
        "wifi": {
            "status": 1,
            "name": "Ole-McLaughlin",
            "mac": "F0:17:38:8F:9D:89",
            "bssid": "6b:c1:a2:18:7f:d7"
        },
        "device": {
            "imei": "857942225967646",
            "serialno": "b5c35937",
            "android_id": "4ac56870dc271490",
            "name": "Redmi K30",
            "gsf_id": "3555f0641c1d1421",
            "gaid": "2a4afd02-f4ea-44c3-9678-c27a6b8e506b"
        },
        "station": {
            "lac": "55",
            "cid": "18"
        }
      }
    ]
}

只修改代理请求示例

json 复制代码

{
  "images": [
    {
      "image_id": "xx",
      "name": "xx",
      "remark": "xx",
      "proxy": {
          "id": "xx",
          "dns": 1
      },
      "gps": {
          "type": 1 // 基于代理IP仿真
      },
      "locale": {
          "type": 1 // 基于代理IP仿真
      }
    }
  ]
}

返回示例

json 复制代码

{
    "code": 200,
    "data": {
        "success": [ // 成功云手机ID
            "xx"
        ],
        "fail": [ // 失败云手机ID
            "xx"
        ],
        "fail_reason": {
            "image_id": "xx"
        }
    },
    "message": "Success"
}

上一个

开启/关闭云手机代理

下一个

手机型号列表

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

大纲