CLOUSD
Создать аккаунт
УзнатьБенчмаркКак агенты справляются на телефонах ClousdБлогСкороГайды, разборы и заметки из практикиСравнениеСкороClousd рядом с альтернативами
РазработкаИнтеграцииСкороMCP, Claude Code, Codex, Cursor, n8nGitHubSDK, MCP-сервер и примеры
Читать документацию

С чего начать

Первое устройство

От нового аккаунта до телефона, которым вы управляете из скрипта, — за пять шагов.

Пять шагов

  1. Создайте аккаунт

    Зарегистрируйтесь по почте, через Google или GitHub. Бесплатный тариф — это 30 минут пробного периода на Pixel 7, 7a или 8 с Android 14, без карты.

  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 или такой модели не существует. Проверьте GET /v1/models.