モード、モデル、料金

ブラウザエージェントの実行は、モードごとのステップ単価で課金されます。モデル料金は含まれています。1 ステップあたり 1 分を超える時間（主に人の対応待ち）は分単位で課金されます。独自にモデルを指定した場合は、そのトークン料金が別途加算されます。このページの価格は現時点のものです。最新のステップ単価はブラウザエージェントのページで常に確認できます。

モードを選ぶ#

実行の開始時に mode を指定します。どちらのモードも同じブラウザと同じ API を使います。

まずは fast から始めてください。より速く、ほとんどのタスクをこなせます。高速モードで失敗するタスクは accurate に切り替えます。実在の Web サイトを使った 78 タスクのベンチマークでは、高精度モードのほうが多くのタスクを完了しました。

curl https://lovelyrouter.com/v1/browser/runs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "goal": "Find the opening hours of the Louvre on Tuesdays in December 2026.",
    "start_url": "https://www.louvre.fr/en",
    "mode": "accurate"
  }'

このページの Python と Node.js のサンプルは、最初のタスクを実行するで定義した API、H、headers を使います。実行オブジェクトの mode には、実際に使われたモードが入ります。fast と accurate 以外の値を指定すると 400 が返ります。

高精度モードでは、エージェントがシークレットをページに入力した後はスクリーンショットを撮りません。テキストと違い、スクリーンショットからはシークレットを取り除けないためです。

独自のモデルを使う#

デフォルトでは、エージェントはステップ単価に含まれるモデルで動作します。好みのモデルを使うには、GET /v1/models にあるモデル ID を model に指定します。

curl https://lovelyrouter.com/v1/browser/runs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "goal": "Compare the three plans on the pricing page and tell me which one includes SSO and what it costs per month.",
    "start_url": "https://example.com/pricing",
    "model": "claude-sonnet-5.5",
    "max_model_usd": 0.60
  }'

指定したモデルは、エージェントが次のステップに迷ったときの思考、入力欄に入力するテキストの作成、最終回答の作成、data の抽出を担当します。定型的なステップの選択には、エージェント独自の高速なモデルを引き続き使います。

課金の仕組み：

• ステップ：モードの通常のステップ単価で課金されます。
• モデルのトークン：通常の API リクエストとして、モデルの通常価格で残高から課金されます。ログでは、実行に使った API キーの下に表示されます。
• 20% の上乗せ料金：トークン料金の 20% が、実行の charge_usd に加算されます。

仮押さえでカバーされるのは上乗せ料金だけで、トークン料金そのものは含まれません。実行中は、モデルのリクエストに足りる残高を確保しておいてください。

実行オブジェクトの model_usd には、それまでにモデルにかかった費用（トークン料金と上乗せ料金の合計）が表示されます。

max_model_usd はこの金額（トークン料金と上乗せ料金の合計、USD）の上限です。省略すると、max_steps とモデルの価格から予算が見積もられます。モデルの利用額が予算に近づくと、実行はステータス failed、エラー reached the model budget ($0.6000); raise max_model_usd で停止します。予算の一部は、最終回答とデータ抽出のために確保されます。

独自のモデルを使う場合、エージェントは高精度モードでもスクリーンショットを使いません。

指定したモデルがブラウザエージェントで使えない場合、リクエストは 400 と Model "…" is not available. Use a model id from GET /v1/models. を返します。

時間と待機#

課金されるステップには、それぞれ 1 分が含まれます。1 ステップにかかるのは数秒なので、エージェントの作業だけでこれを超えることはほぼありません。ブラウザが長く開いたままになると、時間が課金されます。

• 人の対応待ち。 一時停止（質問、承認、引き渡し、引き継ぎ）にも、それぞれ 1 分が含まれます。それを超えると、あなたが返信するか実行がタイムアウトするまで、待機時間に 1 分あたり $0.005 かかります。
• 遅いステップ。 非常に遅いページなどで 1 分を超えたステップは、超過分が課金されます。

実行オブジェクトの billable_time_s と time_usd には、進行中の待機も含め、それまでの課金対象の時間とその費用が表示されます。待機の費用に上限を設けるには、human_timeout_minutes を下げてください。それより長く待った実行は timed_out で終了します。

仮押さえの仕組み#

実行の開始時に、かかりうる最大額を仮押さえします。仮押さえした額はすぐに残高から差し引かれます。実行が終了すると、使った分だけが請求され、残りは残高に戻ります。

仮押さえ額は次の合計です。

1. ステップ： max_steps × モードのステップ単価。
2. 1 回分の待機： (human_timeout_minutes − 1) × $0.005。実行が人の対応待ちで一時停止しうる場合に加算されます。"human": false と "approve": "none" の両方を設定しない限り、実行は一時停止する可能性があります。
3. モデルの上乗せ料金： モデル予算の 6 分の 1（予算のうち 20% の上乗せ料金に当たる部分）。model を指定した場合のみ。

実行オブジェクトの reserved_usd には、実行中は仮押さえ額が表示され、精算後は 0 になります。残高が仮押さえ額に満たない場合、開始リクエストは 402 を返します。max_steps か human_timeout_minutes を下げるか、チャージしてください。仮押さえによって API キーの利用上限を超える場合も 402 を返します。

実行の請求額#

実行が終了すると、ステータスにかかわらず、次の金額が請求されます。

• 実行したステップ数 × モードのステップ単価（人を待つ一時停止は含まず、最大で max_steps）
• さらに課金対象の時間 × 1 分あたり $0.005
• さらに独自モデルのトークン料金に対する 20% の上乗せ料金（model を指定した場合）

請求額が仮押さえ額を超えることはありません。失敗した実行や停止した実行も、実行したステップ分は支払います。charge_usd には、実行の終了から数秒後の精算時に請求額が表示されます。

費用の例#

利用額を確認する#

• 実行オブジェクトの charge_usd、billable_time_s、time_usd、model_usd。
• 使用量とログ：ブラウザエージェントの実行は、他のツールの利用額とあわせて表示されます。独自モデルのリクエストは、他の API 呼び出しと同様にログに表示されます。
• クレジットと請求：残高、チャージ、仮押さえ。