> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-codex-docs-supported-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use https://docs.browser-use.com/llms.txt and its linked .md pages for current documentation. The managed full bundle is https://docs.browser-use.com/.well-known/llms-full.txt and can be cached for up to 24 hours. Do not use the obsolete /cloud/llms*.txt or /open-source/llms*.txt static exports.
> Choose Cloud API V4 for new agent integrations; V2 is the lower-cost option for simple tasks. Keep V3 examples explicitly versioned. The open-source browser-use library and hosted browser-use-sdk have different APIs.
> Cloud authentication uses X-Browser-Use-API-Key, without a Bearer prefix. Install or upgrade browser-use-sdk and use its explicit v4 import for V4. Check the published OpenAPI reference for request fields; do not invent SDK support for new fields.
> Cloud concurrency and HTTP request rate are separate. Read GET /api/v2/billing/account for the key’s projectId, concurrentSessionLimit, activeSessionCount, and credit balance, including when using V4. Keys in one project share capacity and credits; rateLimit is a legacy concurrency alias, not requests per second.
> Keep the highest applicable existing, legacy-plan, and spend-tier concurrency grant. Current spend tiers are 10 / 50 / 250 / 500 / 1000 at $0 / $200 / $1000 / $5000 / $25000 in qualifying project payments. Legacy or externally billed projects can follow different billing paths; trust the account limit. See https://docs.browser-use.com/cloud/guides/concurrency.md.
> Budget polling across the project: the standard general bucket is 25 requests/second, including V4 event reads and full run reads. Selected status reads have a separate higher bucket. Use bounded workers, stagger polls, respect Retry-After, and drain hasMore event pages after terminal status. A busy V4 session returns 409; its queue holds 10 pending messages and is not a project-wide batch queue.
> A completed run or closed CDP connection does not immediately stop its cloud browser. Stop unneeded owned browsers with PATCH /api/v4/browsers/{id} and {"action":"stop"}. A client wait timeout does not cancel the server-side run.
> Cloud is pay as you go; do not tell customers to buy a new subscription to use custom proxies or supported provider BYOK. Usage funding and model eligibility still apply. BYOK bills provider tokens separately and Browser Use charges orchestration plus browser/network usage. See https://docs.browser-use.com/cloud/guides/billing.md.
> Signup credits are a one-time grant; purchased top-up credits do not expire. Check the API key’s project before diagnosing missing credits. API-key monthly spending caps are soft limits, not a strict prepaid wallet; concurrent or already-running work can exceed them. Auto recharge has separate trigger and purchase amounts and can charge immediately when enabled below the threshold. Use https://browser-use.com/pricing for current rates.

# Models

> Choose a V4 model and understand its token pricing.

Omit `model` to use **GPT-5.6 Luna**, or pass a model ID when creating a run.
These are the recommended Browser Use-hosted models with published token
pricing:

| Model                      | API string      |  Input | Cache read |  Output | BYOK      |
| -------------------------- | --------------- | -----: | ---------: | ------: | --------- |
| GPT-5.6 Luna (recommended) | `gpt-5.6-luna`  | \$0.24 |    \$0.024 |  \$1.44 | OpenAI    |
| Claude Opus 5              | `claude-opus-5` | \$6.00 |     \$0.60 | \$30.00 | Anthropic |
| Grok 4.5                   | `grok-4.5`      | \$2.40 |     \$0.36 |  \$7.20 | —         |
| GPT-5.6 Sol                | `gpt-5.6-sol`   | \$6.00 |     \$0.60 | \$36.00 | OpenAI    |
| MiniMax M3                 | `minimax-m3`    | \$0.36 |    \$0.072 |  \$1.44 | —         |

Token prices are USD per 1 million tokens. Browser sessions
(\$0.02/hour) and network traffic (\$5/GB managed proxy or \$0.20/GB
proxyless/BYOP) are charged separately. See [full pricing](https://browser-use.com/pricing).

See [Thinking levels](/cloud/agent/thinking-levels) for V4 `modelParams` and
the normalized `thinkingLevel` values available in V2 and V3.

<Tip>
  We recommend **GPT-5.6 Luna** for most tasks. It combines near-Opus benchmark
  performance with the lowest token price and fastest median response time in
  current V4 production traffic.
</Tip>

## All supported V4 model IDs

The V4 request schema accepts the following model IDs. The Cloud dashboard may
show a smaller curated set; availability can also depend on your account's
rollout and configured provider key.

| Provider    | Model IDs                                                                                  | BYOK provider |
| ----------- | ------------------------------------------------------------------------------------------ | ------------- |
| Anthropic   | `claude-opus-4.7`, `claude-opus-4.8`, `claude-opus-5`, `claude-fable-5`, `claude-sonnet-5` | Anthropic     |
| OpenAI      | `gpt-5.5`, `gpt-5.6`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`                       | OpenAI        |
| Google      | `gemini-3-flash`, `gemini-3.1-pro`, `gemini-3.5-flash`, `gemini-3.6-flash`                 | Google        |
| xAI         | `grok-4.5`                                                                                 | —             |
| Z.ai        | `glm-5.2`                                                                                  | —             |
| Moonshot AI | `kimi-k3`                                                                                  | —             |
| MiniMax     | `minimax-m3`                                                                               | —             |

See [Thinking levels](/cloud/agent/thinking-levels) for the reasoning controls
accepted by each model. Not every model accepts `modelParams`.

<CodeGroup>
  ```python Python theme={null}
  from browser_use_sdk.v4 import BrowserUse

  client = BrowserUse()
  run = client.runs.create(
      "Compare three project-management tools",
      model="gpt-5.6-luna",
  )
  ```

  ```typescript TypeScript theme={null}
  import { BrowserUse } from "browser-use-sdk/v4";

  const client = new BrowserUse();
  const run = await client.runs.create({
    task: "Compare three project-management tools",
    model: "gpt-5.6-luna",
  });
  ```

  ```bash curl theme={null}
  curl https://api.browser-use.com/api/v4/runs \
    -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"task":"Compare three PM tools","model":"gpt-5.6-luna"}'
  ```
</CodeGroup>

## Bring your own key

BYOK is available to pay-as-you-go customers; no recurring subscription is required. After adding credits, add an Anthropic, OpenAI, or Google key under **Settings →
API Keys → Bring Your Own Key**. V4 uses it automatically for matching models;
no request flag is needed. You pay the provider directly, plus a 0.2× Browser
Use orchestration fee. Models from other providers use Browser Use-managed
keys.