模式、模型与价格

浏览器智能体的运行按步计费，每步价格取决于模式。模型费用已包含在内。每步超过一分钟的时长（大多花在等待人工上）按分钟计费。如果你自选模型，其 token 费用另计。本页价格为当前价格；浏览器智能体页面始终显示实时的每步价格。

选择模式#

启动运行时设置 mode。两种模式使用相同的浏览器和相同的 API。

先用 fast。它更快，能处理大多数任务。某个任务在快速模式下失败时，再把它切换到 accurate：在我们基于真实网站的 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。常规步骤的选择仍由智能体自带的快速模型负责。

计费方式：

• 步骤按该模式的常规每步价格计费。
• 模型 token 作为普通 API 请求，按该模型的正常价格从你的余额扣费。它们会显示在日志中，归在该运行所用的 API 密钥下。
• 20% 附加费按这些 token 费用计算，计入运行的 charge_usd。

预留金额只覆盖附加费，不包括 token 本身，因此在运行进行期间，请保持足够的余额来支付模型请求。

运行对象中的 model_usd 显示模型目前产生的费用，即 token 加附加费。

max_model_usd 为这笔费用设置上限（token 加附加费，单位为美元）。如果不设置，系统会根据 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.

时长与等待#

每个计费步骤都包含一分钟。一步只需几秒钟，所以单靠智能体工作几乎不会超出。只有浏览器保持打开更久时，才会产生时长费用：

• 等待人工。 每次暂停（提问、批准、移交、接管）也包含一分钟。超出部分按每分钟 $0.005 计费，直到你回复或运行超时。
• 较慢的步骤。 耗时超过一分钟的步骤（例如遇到非常慢的页面）按超出部分计费。

运行对象中的 billable_time_s 和 time_usd 显示目前的计费时长及其费用，包括正在进行中的等待。要控制等待费用，可以调低 human_timeout_minutes：等待更久的运行会以 timed_out 结束。

预留机制#

运行开始时，会预留（冻结）它最多可能产生的费用。预留金额会立即从你的余额中扣除。运行结束时，按实际用量扣费，剩余的预留金额退回。

预留金额是以下各项之和：

1. 步骤： max_steps × 该模式的每步价格。
2. 一次等待： (human_timeout_minutes − 1) × $0.005，前提是该运行可以暂停等待人工。除非你同时设置 "human": false 和 "approve": "none"，否则运行都可以暂停。
3. 模型附加费： 模型预算的六分之一（即其中属于 20% 附加费的部分），仅在你传入 model 时计入。

运行进行期间，运行对象中的 reserved_usd 显示预留金额，结算后为 0。如果你的余额低于预留金额，启动请求会返回 402。请调低 max_steps 或 human_timeout_minutes，或充值。如果预留会使该 API 密钥超出其消费上限，同样会返回 402。

一次运行的扣费#

运行结束时，无论状态如何，扣费为：

• 已执行的步数 × 该模式的每步价格，不计等待人工的暂停，且最多按 max_steps 计
• 加上计费时长 × 每分钟 $0.005
• 加上自选模型 token 的 20% 附加费（如果你传入了 model）

扣费永远不会超过预留金额。失败或被你停止的运行，按已执行的步数付费。运行结算后（结束几秒钟后），charge_usd 会显示扣费金额。

费用示例#

查看你的花费#

• 运行对象中的 charge_usd、billable_time_s、time_usd 和 model_usd。
• 用量与日志：浏览器智能体的运行与你的其他工具消费一起显示。自选模型的请求和其他 API 调用一样显示在日志中。
• 额度与计费：余额、充值与预留金额。