开始使用
第一台设备
五步完成:从刚注册的账户,到一台用脚本控制的手机。
五个步骤
创建账户
用邮箱、Google或GitHub注册。免费套餐可在Android 14的Pixel 7、7a或8上免费试用30分钟,无需绑卡。
选择套餐或充值
在控制台中打开菜单底部的账户卡片,选择查看全部套餐;或者在设置 → 账单中充值,按分钟计费。套餐决定可同时运行几台手机,并包含手机分钟数。详见套餐与计费。
创建API密钥
打开设置 → 连接 → API密钥并创建密钥。密钥只显示一次。
创建设备
先列出机型,再用你需要的机型创建手机。
等待运行
手机先显示为
starting,大约一分钟后变为running。
创建设备
第一台设备
export CLOUSD_KEY=cl_live_your_key # 1. the models you can create curl https://api.clousd.com/v1/models -H "Authorization: Bearer $CLOUSD_KEY" # 2. create a phone of one model curl -X POST https://api.clousd.com/v1/devices \ -H "Authorization: Bearer $CLOUSD_KEY" \ -H "Idempotency-Key: first-device-001" \ -d '{"profile":"MODEL_ID"}' # → 202 {"ok": true, "name": "c3f9a41d2", "state": "starting", "poll": "/v1/devices/c3f9a41d2"} # 3. poll until it is running curl https://api.clousd.com/v1/devices/c3f9a41d2 -H "Authorization: Bearer $CLOUSD_KEY"
Idempotency-Key请求头为必填项。如果请求超时,你在10分钟内用同一个键重新发送,得到的会是同一台设备,而不会多建一台。
在控制台中
打开设备 → 新建设备,选择Android版本(12到17),点击创建,机型会自动分配。通过API则由你自己选择机型。手机显示启动中,大约一分钟后就绪。打开它即可查看实时画面,用鼠标和键盘操作。
创建失败时
| 响应 | 含义 |
|---|---|
| 402 no_plan | 账户的套餐未付费。请在“设置 → 账单”中更新银行卡。 |
| 402 insufficient_funds | 按分钟计费需要账户有余额。请在“设置 → 账单”中充值,或选择套餐。 |
| 409 plan_full | 套餐内的手机已全部占用。请关机或删除一台手机,或为套餐增加手机。 |
| 400 bad_request | 请求体缺少profile,或机型id不存在。请查看GET /v1/models。 |