Get started

Your first device

From a new account to a phone you control from a script, in five steps.

Five steps

1. Create an account

   Sign up with email, Google or GitHub. The Free plan gives you one phone for 30 minutes, without a card.

2. Choose a plan

   In the dashboard open Billing → Plan. A plan sets how many phones you can run at once; device time is unlimited. See Plans and billing.

3. Create an API key

   Open API & MCP in the dashboard and create a key. It is shown once.

4. Create a device

   List the models, then create a phone of the one you need.

5. Wait until it is running

   The phone appears as starting and becomes running in about a minute.

Create a device

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"

In the dashboard

Open Devices → New device, pick a model and an Android version and press Create. The phone shows Starting and is ready in about a minute. Open it to see its screen live and control it with your mouse and keyboard.

If create fails