ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
APIを持たないアプリもあります。入り口が画面しかないのです。クラウドフォンはクラウド上で動く実機のAndroid 14端末で、あなたのコードが /v1/phones 経由で操作します。APKからアプリをインストールしたら、あとは平文の目標を添えてフォンエージェントに端末を渡すか、自分のコードからタップ・入力・スワイプを行います。人はどのブラウザからでも画面をライブで見たり、操作を引き継いだりできます。フォンの料金は起動中の1時間あたり$1.20、1分単位の課金で、スリープ中は無料です。
AI エージェントに任せる
このプロンプトを 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>
フォンを扱う2つの方法
| フォンエージェント | 直接操作 | |
|---|---|---|
| 送るもの | 目標:「アプリを開いてTermuxを検索し、最初の結果を教えて」 | タップ、スワイプ、文字入力、キー押下を1アクションずつ |
| 各ステップの判断 | エージェントが画面を読み、目標を達成するまで操作 | 自分のコード、または自作のエージェント |
| 返ってくるもの | answer と、trace=1 の場合はステップ | {"ok": true}、指定すればアクション後の画面 |
| 追加コスト | チャットモデルのトークンを通常のAPI料金で | フォン以外になし |
どちらも同じフォンを使うので、組み合わせられます。エージェントにログインさせ、その後は自分でスクリーンショットを撮って残りを操作してください。
新しいフォンで目標を実行する
実行を開始する
POST /v1/phones/runsはフォンを作成し、指定したアプリをインストールしてエージェントを開始します。すぐに202、実行のid、phone_idを返します。新しいフォンの起動には1分ほどかかり、アプリのインストール中はさらに長くかかります。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 です。
(デフォルト): チャットモデルが各ステップを判断し、1ステップに数秒かかります。判断が必要な目標に使ってください。
("mode": "fast"): 高速な判断モデルが、画面の要素とスクリーンショットからほとんどのステップを1秒未満で選ぶため、ボタンでないもの(ゲームの駒や画像など)もタップでき、スワイプも行えます。横でコーチモデルが短い戦略を書き、数ステップごと、または行き詰まったように見えたときに書き直します。どちらもフォンの料金に含まれ、チャットモデルは最終的な回答を書くだけなので、ファストモードの実行はトークン消費も少なくなります。ファストモードはゲーム、ダイアログの消去、既知のフローのタップ操作に向いています。
SMSで届くコード、パスワード、判断が必要な場合、実行は question を伴って waiting になります。POST /v1/phones/runs/{id}/reply で答えるか、ライブ画面で自分でそのステップを行って done と返信してください。
目標に書かれていない限り、エージェントは支払い、送金、データ削除、公開投稿を行いません。POST /v1/phones/runs/{id}/stop は現在のステップの後に実行を終了します。
APKならどんなアプリでも
フォンにはChrome、設定、標準のAndroidアプリ、Google Play servicesが入っていますが、Play Storeはありません。アプリはAPKファイルから入れます。任意の .apk、および分割バンドルの .apks や .xapk に対応し、そのゲームデータ(OBBファイル)もフォンにコピーされます。
- URLで: フォン作成時に
appsへ最大20件のhttps://リンクを指定するか、後からPOST /v1/phones/{id}/appsで1件インストールします。 - アップロードで: 自分のAPKを
PUT /v1/phones/apks/{name}で一度保存し(1リクエストあたり最大100 MB)、任意のフォンに名前でインストールします。500 MBまでのファイルは50 MBのパートに分けて送信し、順不同でも同時でもかまいません。
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に埋め込めるので、ユーザーがエージェントの作業を見たり、手動でログインを済ませたりできます。リンクを知っていれば誰でもタップと入力ができるため、そのフォンを使う相手にだけ共有してください。リンクの有効期間はデフォルトで1時間、最大24時間です。アプリが横向きになったとき、または rotate を送ったとき、スクリーンショットは1200×540になり、ライブ画面も一緒に回転します。ブラウザではフォンコンソールがコードなしでこれをすべて行います。
料金
| 料金 | |
|---|---|
| 起動中のフォン | 1時間あたり$1.20、1分単位の課金 |
| スリープ中のフォン | 無料 |
| エージェントの実行 | チャットモデルのトークンを通常のAPI料金で。ファストモードの判断モデルとコーチモデルは含む |
| アップロードしたAPK | 最初の1 GBは無料、以降は1 GBあたり月$0.30、1時間単位の課金 |
フォンは5分間使われないとスリープし、約2秒で、画面をそのままに復帰します。1時間使われなかったフォンはアプリとデータごと削除されます。自分で削除するには DELETE /v1/phones/{id} を使ってください。フォンの起動には残高に15分分のフォン利用時間が必要で、残高が尽きると実行は止まりフォンはスリープします。フォンはモデル呼び出し、データツール、クラウドエージェントと同じプリペイドキーを使います。サブスクリプションはありません。
よくある質問
クラウドフォンとは何ですか?+
手元ではなくクラウド上で動くAndroid 14のフォンです。実際のAndroidアプリが動き、あなたのコードはAPI経由でスクリーンショット、画面上の要素、アクション、アプリのインストール、ライブ画面リンクにアクセスします。
Play Storeからアプリをインストールできますか?+
いいえ。フォンにはGoogle Play servicesがありますがPlay Storeはないため、アプリはAPKファイルからインストールします。https:// リンクで指定するか、ファイルを一度アップロードして名前でインストールしてください。分割バンドル(.apks、.xapk)も使えます。
フォンは何台まで動かせますか?+
1アカウントにつき同時に3台までです。1台のフォンは一度に1つの目標を実行し、同じフォンで2つ目の実行をすると、最初の実行が終わるまで 409 になります。
フォンがアイドルの間も料金を払いますか?+
最大5分間です。5分間使われないとフォンはスリープし、次に使うまで料金はかかりません。1時間使われないと削除されます。
自作のエージェントでフォンを操作できますか?+
はい。スクリーンショットと要素のエンドポイント、アクションのエンドポイントをツールとして渡すか、任せたい部分はフォンエージェントの実行を開始させてください。
誰かがエージェントを眺めたり手伝ったりできますか?+
はい。ライブ画面リンクはどのブラウザでもフォンを表示し、その人がタップと入力を行えます。エージェントがコードや選択を必要とすると、あなたの返信を待ちます。
すべてのフィールド、上限、エラーはフォンAPIリファレンスにあります。エージェントにフォンではなくブラウザを渡すには、ブラウザエージェントをご覧ください。