С чего начать
Первое устройство
От нового аккаунта до телефона, которым вы управляете из скрипта, — за пять шагов.
Пять шагов
Создайте аккаунт
Зарегистрируйтесь по почте, через Google или GitHub. Бесплатный тариф — это 30 минут пробного периода на Pixel 7, 7a или 8 с Android 14, без карты.
Выберите тариф или пополните баланс
В панели откройте карточку аккаунта внизу меню и выберите Все тарифы или пополните баланс в разделе Настройки → Оплата, чтобы платить поминутно. Тариф задаёт, сколько телефонов работает одновременно, и включает минуты телефонов. Подробнее — в разделе Тарифы и оплата.
Создайте 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"
В панели
Откройте Устройства → Новое устройство, выберите версию Android (от 12 до 17) и нажмите Создать — модель подберётся сама. Через API модель вы выбираете сами. Телефон показывает Запускается и примерно через минуту готов. Откройте его, чтобы видеть экран в реальном времени и управлять им мышью и клавиатурой.
Если создать не удалось
| Ответ | Что это значит |
|---|---|
| 402 no_plan | Тариф аккаунта не оплачен. Обновите карту в разделе «Настройки → Оплата». |
| 402 insufficient_funds | Для поминутной оплаты нужны деньги на балансе. Пополните баланс в разделе «Настройки → Оплата» или выберите тариф. |
| 409 plan_full | Все телефоны тарифа заняты. Остановите или удалите телефон либо добавьте телефоны в тариф. |
| 400 bad_request | В теле запроса нет profile или такой модели не существует. Проверьте GET /v1/models. |