Режимы, модели и цены

Запуск браузерного агента оплачивается за шаг по цене его режима. Модели включены. Время сверх одной минуты на шаг, которое в основном уходит на ожидание человека, оплачивается поминутно. Если вы выбираете свою модель, её токены оплачиваются дополнительно. Цены на этой странице актуальны; на странице браузерного агента всегда указана текущая цена шага.

Выбор режима#

Задайте 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.

В точном режиме агент перестаёт делать скриншоты, как только ввёл на страницу секрет, потому что скриншот нельзя вычистить так, как текст.

Использование своей модели#

По умолчанию агент работает на моделях, включённых в цену шага. Чтобы использовать предпочитаемую модель, передайте её id из GET /v1/models в 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% к стоимости этих токенов добавляется к 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.

Время и ожидание#

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

• Ожидание человека. Каждая пауза (вопрос, подтверждение, передача управления, перехват управления) тоже включает одну минуту. Сверх этого ожидание стоит $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 либо пополните баланс. 402 возвращается также, если резерв превысил бы лимит расходов API-ключа.

Сколько списывается за запуск#

Когда запуск завершается, при любом статусе с него списывается:

• выполненные шаги × цена шага режима, без учёта пауз ради человека и не больше max_steps
• плюс оплачиваемое время × $0.005 в минуту
• плюс надбавка 20% к токенам вашей модели, если вы передали model

Списание никогда не превышает резерв. Неудачный или остановленный вами запуск оплачивает сделанные шаги. charge_usd показывает списание после расчёта запуска, через несколько секунд после его завершения.

Примеры стоимости#

Как посмотреть расходы#

• charge_usd, billable_time_s, time_usd и model_usd в объекте запуска.
• Использование и логи: запуски браузерного агента отображаются вместе с другими расходами на инструменты. Запросы вашей собственной модели видны в Логах, как любой другой вызов API.
• Кредиты и оплата: баланс, пополнения и резервы.