菜单

初始化代理

使用说明

初始化代理

请求说明

POST /api/v1/cloudPhone/initProxy

请求参数

参数	类型	必需	说明
images	array	是

images

参数	类型	必需	说明
image_id	string	是	云手机ID
name	string	否	名称
ip_scan_channel	string	是	IP查询渠道，目前支持：ip2location、ipapi
proxy	Object	是	代理
dpi_name	string	否	分辨率，具体值请查看本文的附表1
network_mode	string	否	联网方式，1 Wi-Fi；2 移动数据，Android 10/Android 11/Android 12(区域B) 的云手机只支持 Wi-Fi 联网
brand	string	否	设备品牌，未设置品牌时默认随机，具体Android版本支持的品牌可通过手机型号接口获取
model	string	否	手机型号，未设置型号时默认随机，具体Android版本支持的型号可通过手机型号接口获取
location	Object	否	地理位置，未设置时默认基于IP仿真
sim	Object	否	SIM卡，未设置时默认基于代理IP仿真
locale	Object	否	时区和语言，未设置时默认基于代理IP仿真

proxy

参数	类型	必需	说明
id	string	否	代理ID, 可通过代理列表接口获取
host	string	否	IP或域名，未传代理ID时必传，暂不支持 IPv6 类型
port	integer	否	端口，未传代理ID时必传
user	string	否	账号，仅支持大小写字母、数字、!@#$%^&*();:.,/~+-_?<>[]=
password	string	否	密码，仅支持大小写字母、数字、!@#$%^&*();:.,/~+-_?<>[]=
protocol	string	否	代理类型，支持 socks5，http，https，未传时默认为 socks5

location

参数	类型	必需	说明
longitude	integer	是	经度，范围：-180 ~ 180
latitude	integer	是	纬度，范围：-90 ~ 90

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、运营商信息等信息匹配好，请谨慎使用！

locale

参数	类型	必需	说明
country	string	是	地区，必须符合 ISO 3166-1 alpha-2 格式，完整的国家代码列表可通过 ISO 3166 国家代码列表获取
timezone	string	是	时区，支持的时区可通过时区列表接口获取
language	integer	否	语言，未设置时默认基于IP仿真，可通过语言列表接口获取语言编码

附表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 复制代码

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

返回示例

json 复制代码

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

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

大纲