CLOUSD
注册账户
了解基准测试Agent在Clousd手机上的得分博客即将推出指南、深度解析和实践笔记对比即将推出Clousd与其他方案对比
开发集成即将推出MCP、Claude Code、Codex、Cursor、n8nGitHubSDK、MCP服务器和示例
阅读文档

开始使用

第一台设备

五步完成:从刚注册的账户,到一台用脚本控制的手机。

五个步骤

  1. 创建账户

    用邮箱、Google或GitHub注册。免费套餐可在Android 14的Pixel 7、7a或8上免费试用30分钟,无需绑卡。

  2. 选择套餐或充值

    在控制台中打开菜单底部的账户卡片,选择查看全部套餐;或者在设置 → 账单中充值,按分钟计费。套餐决定可同时运行几台手机,并包含手机分钟数。详见套餐与计费。

  3. 创建API密钥

    打开设置 → 连接 → API密钥并创建密钥。密钥只显示一次。

  4. 创建设备

    先列出机型,再用你需要的机型创建手机。

  5. 等待运行

    手机先显示为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。