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

API облачных телефонов для ИИ-агентов

Настоящие Android 14 в облаке. Ставьте любой APK, дайте ИИ-агенту цель словами или управляйте экраном сами. Оплата за час бодрствования.

Обновлено 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%
Зарегистрироваться и получить

У некоторых приложений нет 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>
01

Два способа работать с телефоном

Телефонный агентПрямое управление
Вы отправляетеЦель: «Открой приложение, найди Termux и скажи мне первый результат»Нажатия, свайпы, ввод текста и нажатия клавиш, по одному действию за раз
Кто решает каждый шагНаш агент читает экран и действует, пока цель не будет достигнутаВаш код или ваш собственный агент
Вы получаете в ответanswer, а также шаги при trace=1{"ok": true} и экран после действия, если попросите
Дополнительная стоимостьТокены чат-модели по обычной цене APIНет, кроме самого телефона

Оба способа используют один и тот же телефон, поэтому их можно смешивать: дайте агенту войти в аккаунт, а затем делайте скриншоты и управляйте остальным сами.

02

Выполнить цель на новом телефоне

  1. Запустите выполнение

    POST /v1/phones/runs создаёт телефон, устанавливает перечисленные приложения и запускает агента. Ответ приходит сразу: 202, id запуска и его phone_id. Новый телефон запускается примерно за минуту, дольше, пока устанавливаются приложения.

    cURL
    curl 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"]
      }'
  2. Дождитесь ответа

    GET /v1/phones/runs/{id}?wait=50 удерживает запрос до 50 секунд и отвечает досрочно, когда запуск завершается или задаёт вам вопрос.

    Python
    import 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"])
  3. Сохраните телефон

    После запуска телефон остаётся вашим вместе с приложениями и выполненными входами. Отправьте ему следующую цель через POST /v1/phones/{phone_id}/runs.

    Node.js
    const 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);
03

Телефонный агент

Агент читает то, что на экране, нажимает, печатает и прокручивает, пока цель не будет достигнута. Пишите цель со всеми значениями, которые нужны задаче, до 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 завершает запуск после текущего шага.

04

Любое приложение из 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
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"}'
05

Управляйте экраном сами

Ваш собственный код или построенный вами агент может работать с телефоном напрямую. Координаты — это пиксели скриншота, короткая сторона которого равна 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
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}'
06

Живой экран, портрет или ландшафт

POST /v1/phones/{id}/screen возвращает ссылку на живой экран телефона. Она открывается в любом браузере без плагинов и может размещаться в iframe на вашей странице, чтобы пользователь мог смотреть за работой агента или вручную завершить вход. Любой, у кого есть ссылка, может нажимать и печатать, поэтому делитесь ею только с тем, кто должен пользоваться телефоном; по умолчанию она действует час, максимум 24 часа. Когда приложение переходит в ландшафт или вы отправляете rotate, скриншот становится 1200×540, и живой экран поворачивается вместе с ним. В браузере всё это делает консоль телефона без кода.

07

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

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

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

08

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

?
Что такое облачный телефон?+

Это телефон на Android 14, который работает в облаке, а не в вашей руке. На нём запускаются настоящие приложения Android, а ваш код обращается к нему через API: скриншоты, элементы на экране, действия, установка приложений и ссылка на живой экран.

Можно ли устанавливать приложения из Play Store?+

Нет. На телефоне есть сервисы Google Play, но нет Play Store, поэтому приложения ставятся из APK-файлов: по ссылке https:// или загрузкой файла один раз с последующей установкой по имени. Split-бандлы (.apks, .xapk) тоже работают.

Сколько телефонов можно запустить?+

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

Плачу ли я, пока телефон простаивает?+

В течение 5 минут. После 5 минут без использования телефон засыпает и ничего не стоит, пока вы снова его не используете. Через 1 час без использования он удаляется.

Может ли мой собственный агент управлять телефоном?+

Да. Дайте ему эндпоинты скриншота и элементов, а также эндпоинт действий в качестве инструментов, или позвольте ему запускать нашего телефонного агента для тех частей, которые он предпочтёт передать.

Может ли кто-то наблюдать за агентом или помогать ему?+

Да. Ссылка на живой экран показывает телефон в любом браузере и позволяет человеку нажимать и печатать. Когда агенту нужен код или выбор, он ждёт вашего ответа.

Все поля, лимиты и ошибки описаны в справочнике по API телефонов. Чтобы дать агенту браузер вместо телефона, см. браузерный агент.

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

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