Бонус за пополнение: Чёрная пятница·Пополните от $50 и получите $10 · Пополните от $100 и получите $25·До 30 ноябряПополнить →
Сценарий использования

Тестирование мобильных приложений с ИИ на реальных Android-телефонах в облаке

Установите APK на облачный Android-телефон и дайте ИИ-агенту пройти тестовые цели простыми словами: скриншоты, трассировка шагов и живой экран.

Обновлено 2026-11-05

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
cloud phone$ curl -X POST https://lovelyrouter.com/v1/phones -H "Authorization… ✓ phone ready · Android · 35 s ⏺ install app.apk> Sign up with a test account and add one item to the cart. tap "Sign up" · type email · tap "Add to cart" ✓ done · 9 steps · screenshot saved
Чёрная пятница

Бонус за пополнение: Чёрная пятница

Каждое подходящее пополнение даёт бесплатные средства, а также суммируется с другими предложениями.

До 30 ноября

Пополнение $50
+$10
Бонус 20%
Пополнение $100
+$25
Бонус 25%
Зарегистрироваться и получить

Скриптовые UI-тесты ломаются каждый раз, когда сдвигается кнопка, а человек, прокликивающий одни и те же сценарии перед каждым релизом, не масштабируется. Вместо него нажимать может ИИ-агент: вы описываете тест простыми словами («зарегистрируйся с этой почтой, добавь товар в корзину, проверь итог»), а агент читает экран, нажимает, вводит текст и прокручивает, пока не сделает это или не выяснит, что не может. Облачные телефоны Lovely Router — это настоящие Android 14 телефоны в облаке. Установите на него свой APK, отправляйте тестовые цели через /v1/phones и получайте обратно pass или fail, ответ агента и каждый сделанный шаг. Телефон стоит $1.20 в час, пока он бодрствует, с оплатой по минутам, и ничего, пока он спит.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Upload my Android build to a Lovely Router cloud phone and run a short suite of plain-language test goals against it, reporting pass or fail with the agent's steps.

- Docs (read first): https://lovelyrouter.com/docs/phone.md and https://lovelyrouter.com/docs/api/phones.md
- Create a phone, upload and install the APK, start one agent run per test goal and poll it; collect each run's steps and final answer. Delete the phone at the end (billed while awake).
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the APK and the test flows to check>
01

Как это работает

010203
  1. Загрузите сборку

    Загрузите APK один раз через PUT /v1/phones/apks/{name} — до 100 МБ в одном запросе или до 500 МБ частями по 50 МБ. Разделённые бандлы (.apks, .xapk) тоже работают. Загрузка под тем же именем заменяет файл, так что ваш CI может отправлять каждую новую сборку под одним именем.

  2. Запустите телефон с приложением

    Создайте телефон, указав ваш APK в apps. Новый телефон запускается примерно за минуту, чуть дольше, пока идёт установка. Его поле startup_apps сообщает, удалась ли каждая установка и какой пакет был установлен.

  3. Запускайте каждый тест как цель

    Отправляйте каждый тест в POST /v1/phones/{id}/runs как цель простыми словами, со всеми нужными значениями. Запуск завершается со статусом succeeded, если агент достиг цели, и failed, если он решил, что цель недостижима, с причиной в answer. trace=1 возвращает каждый шаг.

02

Запустите тестовую цель для своего APK

Загрузите сборку, запустите с ней телефон и дождитесь готовности:

cURL
curl -X PUT https://lovelyrouter.com/v1/phones/apks/myapp-latest.apk \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  --data-binary @app/build/outputs/apk/release/app-release.apk

curl https://lovelyrouter.com/v1/phones \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"apps": ["myapp-latest.apk"], "name": "release-check", "wait": 50}'

Затем отправляйте тесты по очереди на один и тот же телефон. Этот скрипт на Python прогоняет короткий набор и печатает результат по каждому тесту:

Python
import os, requests

API = "https://lovelyrouter.com/v1/phones"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}
PHONE = "ph_..."  # the id from POST /v1/phones

TESTS = {
    "signup": "Open MyApp. Sign up with the email qa+signup@example.com and the password Test-1234. "
              "Pass if the home screen greets the new user; report the greeting.",
    "cart": "Open MyApp, search for 'blue mug', add the first result to the cart and open the cart. "
            "Report the item name, quantity and total exactly as shown.",
    "settings": "Open MyApp's settings, switch the language to German and go back to the home screen. "
                "Pass only if the home screen is now in German.",
}

for name, goal in TESTS.items():
    run = requests.post(f"{API}/{PHONE}/runs", headers=H, json={"goal": goal, "max_steps": 40}).json()
    while run["status"] in ("queued", "running"):
        run = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"wait": 50}).json()
    if run["status"] == "waiting":
        print(name, "needs a person:", run["question"])
        continue
    trace = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"trace": 1}).json()["trace"]
    print(f"{name:<10} {run['status']:<10} {run['steps']:>3} steps  {run['answer'] or run['error']}")
    for s in trace:
        if not s["ok"] or s.get("unchanged"):
            print("   step", s["step"], s["action"], s.get("error") or "screen did not change", "-", s["note"])

Телефон выполняет одну цель за раз, поэтому тесты идут по порядку; второй запуск на занятом телефоне получит 409. Чтобы тестировать параллельно, запустите больше телефонов: на аккаунт может быть 3 одновременно.

03

Как агент проходит тест

В режиме по умолчанию smart каждый шаг — это один вызов инструмента чат-моделью. Модель получает элементы на экране (из дерева представлений Android, каждый с позицией и флагами вроде clickable и editable) и скриншот и вызывает ровно один инструмент: tap, long_press, swipe, scroll, type, key, open_url, launch или wait для действия, ask_user, чтобы что-то спросить, или done, чтобы завершить с ответом. Каждый шаг записывает note с тем, что он увидел и почему так поступил, действие, приложение на переднем плане, успешность и unchanged: true, если действие оставило экран точно таким же.

Модель по умолчанию — gemini-3.8-flash; передайте любую чат-модель из списка моделей в model. Её токены тарифицируются по обычной цене API, и запуск сообщает их в llm_usd. Запуск делает до 40 шагов по умолчанию и до 200 с max_steps; дошедший до лимита завершается со статусом stopped.

Пишите цели как тест-кейсы. Дайте агенту все нужные значения (аккаунты, поисковые запросы, ожидаемый текст) и скажите, что считается успехом: «Успех, если итог показан в евро». Агент сообщает увиденное в answer, поэтому попросите его скопировать текст, на который хотите проверять, и проверяйте его в коде.

04

Логины, коды и человек в процессе

Тестовый аккаунт, которому нужен код из SMS, или сценарий, который должен одобрить человек, не обязательно пропускать. Агент вызывает ask_user, запуск переходит в waiting с question, и вы отвечаете через POST /v1/phones/runs/{id}/reply. Либо откройте живой экран, сделайте шаг вручную и ответьте done.

POST /v1/phones/{id}/screen возвращает ссылку на живой экран телефона. Она открывается в любом браузере без плагина, может быть встроена в iframe в вашей панели и позволяет любому, у кого она есть, смотреть и нажимать, поэтому делитесь ею только с тем, кто должен пользоваться телефоном. Консоль телефона делает то же самое без кода.

Агент никогда не платит, не переводит деньги, не удаляет данные и не публикует что-то публично, если этого нет в цели. Для сценариев оплаты всё равно используйте тестовые аккаунты и песочницу платежей.

05

Скриншоты, сбросы и логи

Между запусками агента ваш код может управлять телефоном напрямую (прямое управление):

  • GET /v1/phones/{id}/screenshot сохраняет экран в WebP для тест-отчёта, 540 пикселей по короткой стороне.
  • POST /v1/phones/{id}/actions с {"action": "shell", "command": "pm clear com.example.myapp"} сбрасывает данные приложения перед следующим тестом, а logcat -d -t 300 *:E возвращает последние ошибки в output.
  • {"action": "launch", "package": "com.example.myapp"} открывает приложение на стартовом экране; {"action": "rotate", "orientation": "landscape"} проверяет альбомную вёрстку.
cURL
curl https://lovelyrouter.com/v1/phones/ph_.../actions \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"action": "shell", "command": "logcat -d -t 300 *:E"}'

Установка новой сборки на телефон, где приложение уже есть, обновляет его: POST /v1/phones/{id}/apps с {"apk": "myapp-latest.apk"} возвращает ответ, когда установка завершена.

06

Что он умеет хорошо, а что нет

ИИ-тесты подходят для сценариев, которыми пользуются люди: онбординг, поиск, оплата, настройки, регресс, который можно описать одним предложением. Они продолжают работать при изменении вёрстки, потому что агент читает экран на каждом шаге, а не ищет фиксированный view id. Они медленнее скриптовых тестов (несколько секунд на шаг в режиме smart) и судят по тому, что на экране, поэтому проверки с точным сравнением пикселей или таймингами стоит держать в своём тестовом коде. Каждый телефон — один и тот же Android 14 в облаке, с сервисами Google Play и без Play Store, поэтому он не заменяет тестирование на разных физических устройствах и версиях Android.

07

Сколько вы платите

Цена
Телефон, пока бодрствует$1.20 в час, оплата по минутам
Телефон, пока спитБесплатно
Запуски агентаТокены чат-модели по обычной цене API
Загруженные APKПервый 1 ГБ бесплатно, далее $0.30 за ГБ в месяц

Телефон засыпает через 5 минут без использования и просыпается примерно за 2 секунды с тем же экраном, что был. Телефон, не использованный 1 час, удаляется вместе с приложениями и данными; удаляйте его сами через DELETE /v1/phones/{id}, когда набор тестов закончен. Для запуска телефона нужно 15 минут оплаченного времени телефона на балансе. Тот же предоплатный ключ оплачивает модели, инструменты данных и облачных агентов, без подписки.

08

Частые вопросы

?
Можно ли тестировать свой APK, которого нет ни в одном сторе?+

Да. Загрузите его через PUT /v1/phones/apks/{name} и установите по имени либо укажите в apps ссылку https:// на файл. Подойдёт любой APK, а также бандлы .apks и .xapk.

Как понять, прошёл ли тест?+

Запуск завершается succeeded, если агент достиг цели, и failed, если он решил, что не может, с причиной в answer или error. Попросите агента сообщить нужный вам текст и проверяйте его в своём коде.

Можно ли увидеть, что агент делал на каждом шаге?+

Да. GET /v1/phones/runs/{id}?trace=1 перечисляет действие на каждом шаге, его заметку о том, что он увидел и почему, успешность и изменился ли экран. Для отчёта делайте скриншоты через эндпоинт скриншотов.

Что происходит, когда приложение просит код подтверждения?+

Агент спрашивает вас: запуск переходит в waiting с question и продолжается, когда вы ответите. Вы также можете выполнить шаг сами на живом экране.

Можно ли запускать тесты параллельно?+

Каждый телефон выполняет одну цель за раз, и на аккаунт может быть 3 телефона одновременно, так что параллельно идёт до 3 тестов.

Работает ли это с приложениями для iOS?+

Нет. Облачные телефоны работают только на Android 14.

Хотите агента, который вместо этого играет в игры на телефоне? Смотрите ИИ-агента для игр. Все эндпоинты и поля есть в справочнике phone API, а браузерный агент делает то же самое для веб-приложений.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.