API облачных телефонов для ИИ-агентов
Настоящие Android 14 в облаке. Ставьте любой APK, дайте ИИ-агенту цель словами или управляйте экраном сами. Оплата за час бодрствования.
Обновлено 2026-11-05
Бонус за пополнение: Чёрная пятница
Каждое подходящее пополнение даёт бесплатные средства, а также суммируется с другими предложениями.
До 30 ноября
У некоторых приложений нет API: единственный вход — экран. Облачный телефон — это настоящий телефон на Android 14, который работает в облаке и которым ваш код управляет через /v1/phones. Установите приложение из APK, затем передайте телефон нашему телефонному агенту с целью, сформулированной словами, или нажимайте, печатайте и свайпайте из своего кода. Человек может смотреть на экран в реальном времени или перехватить управление из любого браузера. Телефон стоит $1.20 в час, пока он бодрствует, с оплатой по минутам, и ничего, пока он спит.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Run an Android task for me on a Lovely Router cloud phone: create a phone, install the app I name, and let the phone agent do the goal, or drive it step by step. - Docs (read first): https://lovelyrouter.com/docs/phone.md and https://lovelyrouter.com/docs/api/phones.md - Phones: POST https://lovelyrouter.com/v1/phones creates one; install apps from an https URL or an uploaded APK; start an agent run with a plain-language goal and poll it; answer its questions at the run's reply endpoint. - Billed per awake minute while the phone is awake (asleep is free); delete the phone when you are done. - 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 app, the goal on the phone and what proves it worked>
Два способа работать с телефоном
| Телефонный агент | Прямое управление | |
|---|---|---|
| Вы отправляете | Цель: «Открой приложение, найди Termux и скажи мне первый результат» | Нажатия, свайпы, ввод текста и нажатия клавиш, по одному действию за раз |
| Кто решает каждый шаг | Наш агент читает экран и действует, пока цель не будет достигнута | Ваш код или ваш собственный агент |
| Вы получаете в ответ | answer, а также шаги при trace=1 | {"ok": true} и экран после действия, если попросите |
| Дополнительная стоимость | Токены чат-модели по обычной цене API | Нет, кроме самого телефона |
Оба способа используют один и тот же телефон, поэтому их можно смешивать: дайте агенту войти в аккаунт, а затем делайте скриншоты и управляйте остальным сами.
Выполнить цель на новом телефоне
Запустите выполнение
POST /v1/phones/runsсоздаёт телефон, устанавливает перечисленные приложения и запускает агента. Ответ приходит сразу:202,idзапуска и егоphone_id. Новый телефон запускается примерно за минуту, дольше, пока устанавливаются приложения.cURLcurl https://lovelyrouter.com/v1/phones/runs \ -H "Authorization: Bearer $LOVELY_API_KEY" \ -H "content-type: application/json" \ -d '{ "goal": "Open the F-Droid app, search for Termux, and tell me the one-line summary of the first result.", "apps": ["https://f-droid.org/F-Droid.apk"] }'Дождитесь ответа
GET /v1/phones/runs/{id}?wait=50удерживает запрос до 50 секунд и отвечает досрочно, когда запуск завершается или задаёт вам вопрос.Pythonimport os, requests API = "https://lovelyrouter.com/v1/phones" H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"} run = requests.post(f"{API}/runs", headers=H, json={ "goal": "Open the F-Droid app, search for Termux, and tell me the one-line summary of the first result.", "apps": ["https://f-droid.org/F-Droid.apk"], }).json() while run["status"] in ("queued", "running"): run = requests.get(f"{API}/runs/{run['id']}", headers=H, params={"wait": 50}).json() print(run["status"], run["answer"])Сохраните телефон
После запуска телефон остаётся вашим вместе с приложениями и выполненными входами. Отправьте ему следующую цель через
POST /v1/phones/{phone_id}/runs.Node.jsconst H = { Authorization: `Bearer ${process.env.LOVELY_API_KEY}`, 'content-type': 'application/json' }; const next = await (await fetch(`https://lovelyrouter.com/v1/phones/${phoneId}/runs`, { method: 'POST', headers: H, body: JSON.stringify({ goal: 'Open F-Droid and list the first three apps under Latest.', wait: 50 }), })).json(); console.log(next.status, next.answer);
Телефонный агент
Агент читает то, что на экране, нажимает, печатает и прокручивает, пока цель не будет достигнута. Пишите цель со всеми значениями, которые нужны задаче, до 10 000 символов. Каждый запуск делает до 200 шагов (max_steps, по умолчанию 40) и использует любую чат-модель из списка моделей в качестве model; по умолчанию — gemini-3.8-flash.
(по умолчанию): чат-модель решает каждый шаг, по несколько секунд на шаг. Используйте его для целей, требующих рассуждения.
("mode": "fast"): быстрая модель принятия решений выбирает большинство шагов заметно быстрее секунды по элементам экрана и скриншоту, поэтому она может нажимать и на то, что не является кнопками, — например, на игровые фигуры и картинки, — а также свайпать. Модель-тренер пишет рядом короткую стратегию и переписывает её каждые несколько шагов или когда выполнение заходит в тупик. Обе входят в цену телефона; чат-модель пишет только финальный ответ, поэтому быстрый запуск расходует и меньше токенов. Быстрый режим подходит для игр, закрытия диалогов и прохождения по известному сценарию.
Если агенту нужен код из SMS, пароль или решение, запуск переходит в waiting с question. Ответьте через POST /v1/phones/runs/{id}/reply или выполните шаг сами на живом экране и ответьте done.
Агент никогда не платит, не переводит деньги, не удаляет данные и не публикует записи, если этого нет в цели. POST /v1/phones/runs/{id}/stop завершает запуск после текущего шага.
Любое приложение из APK
На телефоне есть Chrome, «Настройки» и стандартные приложения Android, а также сервисы Google Play, но нет Play Store. Приложения ставятся из APK-файлов: любых .apk и split-бандлов .apks или .xapk, игровые данные которых (OBB-файлы) тоже копируются на телефон.
- По URL: перечислите до 20 ссылок
https://вappsпри создании телефона или установите одно приложение позже черезPOST /v1/phones/{id}/apps. - Загрузкой: сохраните свой APK один раз через
PUT /v1/phones/apks/{name}(до 100 МБ за один запрос) и устанавливайте его по имени на любой телефон. Файлы до 500 МБ загружаются частями по 50 МБ, которые можно отправлять в любом порядке или одновременно.
curl -X PUT https://lovelyrouter.com/v1/phones/apks/myapp.apk \
-H "Authorization: Bearer $LOVELY_API_KEY" \
--data-binary @myapp.apk
curl https://lovelyrouter.com/v1/phones/ph_2758eedebf08496f87e0/apps \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"apk": "myapp.apk"}'Управляйте экраном сами
Ваш собственный код или построенный вами агент может работать с телефоном напрямую. Координаты — это пиксели скриншота, короткая сторона которого равна 540 пикселям.
GET /v1/phones/{id}/screenshotвозвращает экран в формате WebP.GET /v1/phones/{id}/elementsперечисляет кнопки, текст и поля на экране, каждое с центральной точкой, размером и флагами вродеclickableиeditable.POST /v1/phones/{id}/actionsотправляетtap,long_press,swipe,scroll,type(любой язык),key,open_url,launch,stop_app,wait,rotateилиshell. Добавьте"screenshot": true, чтобы увидеть результат.
curl https://lovelyrouter.com/v1/phones/ph_2758eedebf08496f87e0/actions \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"action": "type", "text": "weather Tokyo", "submit": true, "screenshot": true}'Живой экран, портрет или ландшафт
POST /v1/phones/{id}/screen возвращает ссылку на живой экран телефона. Она открывается в любом браузере без плагинов и может размещаться в iframe на вашей странице, чтобы пользователь мог смотреть за работой агента или вручную завершить вход. Любой, у кого есть ссылка, может нажимать и печатать, поэтому делитесь ею только с тем, кто должен пользоваться телефоном; по умолчанию она действует час, максимум 24 часа. Когда приложение переходит в ландшафт или вы отправляете rotate, скриншот становится 1200×540, и живой экран поворачивается вместе с ним. В браузере всё это делает консоль телефона без кода.
Сколько вы платите
| Цена | |
|---|---|
| Телефон, пока он бодрствует | $1.20 в час, с оплатой по минутам |
| Телефон, пока он спит | Бесплатно |
| Запуски агента | Токены чат-модели по обычной цене API; модели принятия решений и тренер быстрого режима включены |
| Загруженные APK | Первый 1 ГБ бесплатно, далее $0.30 за ГБ в месяц, с оплатой по часам |
Телефон засыпает через 5 минут без использования и просыпается примерно за 2 секунды с тем же экраном, каким вы его оставили. Телефон, который не использовали 1 час, удаляется вместе с приложениями и данными, или удалите его сами через DELETE /v1/phones/{id}. Для запуска телефона нужно 15 минут телефонного времени на балансе; когда баланс заканчивается, запуски останавливаются, а телефон засыпает. Телефоны используют тот же предоплатный ключ, что и вызовы моделей, инструменты для данных и облачные агенты; подписки нет.
Частые вопросы
Что такое облачный телефон?+
Это телефон на Android 14, который работает в облаке, а не в вашей руке. На нём запускаются настоящие приложения Android, а ваш код обращается к нему через API: скриншоты, элементы на экране, действия, установка приложений и ссылка на живой экран.
Можно ли устанавливать приложения из Play Store?+
Нет. На телефоне есть сервисы Google Play, но нет Play Store, поэтому приложения ставятся из APK-файлов: по ссылке https:// или загрузкой файла один раз с последующей установкой по имени. Split-бандлы (.apks, .xapk) тоже работают.
Сколько телефонов можно запустить?+
На каждом аккаунте может быть 3 телефона одновременно. Телефон выполняет одну цель за раз; второй запуск на том же телефоне получает 409, пока не завершится первый.
Плачу ли я, пока телефон простаивает?+
В течение 5 минут. После 5 минут без использования телефон засыпает и ничего не стоит, пока вы снова его не используете. Через 1 час без использования он удаляется.
Может ли мой собственный агент управлять телефоном?+
Да. Дайте ему эндпоинты скриншота и элементов, а также эндпоинт действий в качестве инструментов, или позвольте ему запускать нашего телефонного агента для тех частей, которые он предпочтёт передать.
Может ли кто-то наблюдать за агентом или помогать ему?+
Да. Ссылка на живой экран показывает телефон в любом браузере и позволяет человеку нажимать и печатать. Когда агенту нужен код или выбор, он ждёт вашего ответа.
Все поля, лимиты и ошибки описаны в справочнике по API телефонов. Чтобы дать агенту браузер вместо телефона, см. браузерный агент.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.