Skip to main content

​
Model Versions

ModelDescription
n1.5-latestPoints to the latest stable n1.5 model. Currently points to n1.5-20260403.
n1.5-20260403Stable release (2026-04-03).

​
Supported Actions

​
Core Tools

The default tool set (browser_tools_core-20260403). 18 coordinate-based browser tools.
ActionDescriptionRequired ArgsOptional Args
left_clickLeft mouse clickcoordinatesref, modifier
double_clickDouble left clickcoordinatesref, modifier
triple_clickTriple left clickcoordinatesref, modifier
middle_clickMiddle mouse clickcoordinatesref, modifier
right_clickRight mouse clickcoordinatesref, modifier
scrollScroll in a directioncoordinates, direction, amountref, modifier
typeType text into focused inputtext
key_pressPress a key or combinationkey
dragDrag from start to endstart_coordinates, coordinates
mouse_moveMove mouse to a pointcoordinatesref
mouse_downPress and hold left mouse buttoncoordinatesref
mouse_upRelease left mouse buttoncoordinatesref
go_backBrowser back
go_forwardBrowser forward
waitPause executionduration
goto_urlNavigate to URLurl
refreshReload page
hold_keyHold a key downkeyduration
Parameter notes:
  • coordinates is always [x, y] in the normalized 1000x1000 space.
  • ref is an optional DOM element reference, used as an alternative to coordinates in browser contexts.
  • modifier is a modifier key held during the action: ctrl, shift, alt, meta, command, or super.
  • direction for scroll is one of: down, up, left, right.
  • amount for scroll is an integer where 1 unit is approximately 10% of the screen height.

​
Expanded Browser Tools

Includes all core tools plus DOM/ref-based extras (browser_tools_expanded-20260403):
ActionDescriptionRequired ArgsOptional Args
extract_elementsExtract page elementsfilter
findSearch for text on pagetext
set_element_valueSet input value by refref, value
execute_jsExecute JavaScripttext

​
Key Space

n1.5 uses lowercase key names. Combinations are joined with +, and sequential presses are separated by spaces.
CategoryKey Names
Modifiersctrl, alt, shift, meta, command, super
Commonenter, backspace, delete, tab, esc, space
Arrow keysleft, right, up, down
Page navigationpageup, pagedown, home, end
Function keysf1 through f12
Examples: ctrl+c, ctrl+shift+t, alt+left, down down down enter

​
Features

​
Tool Sets

Use the tool_set parameter to select which set of browser tools are available to the model: 
response = client.chat.completions.create(
    model="n1.5-latest",
    messages=[...],
    extra_body={
        "tool_set": "browser_tools_expanded-20260403",
    }
)
Available tool sets:
  • browser_tools_core-20260403 (default) — coordinate-based visual browser tools
  • browser_tools_expanded-20260403 — core + DOM-based tools (extract_elements, find, set_element_value, execute_js)

​
Disabling Specific Tools

Remove specific tools from the active tool set: 
response = client.chat.completions.create(
    model="n1.5-latest",
    messages=[...],
    extra_body={
        "disable_tools": ["hold_key", "drag"],
    }
)

​
JSON Structured Output

Provide a json_schema to get structured data extracted from the model’s response. The schema is appended to your task message, and the model returns JSON inside ```json code fences. The API parses this and returns it as a parsed_json field. 
response = client.chat.completions.create(
    model="n1.5-latest",
    messages=[...],
    extra_body={
        "json_schema": {
            "type": "object",
            "properties": {
                "product_name": {"type": "string"},
                "price": {"type": "number"}
            },
            "required": ["product_name", "price"]
        }
    }
)

# Access the parsed result
parsed = response.parsed_json  # {"product_name": "Widget Pro", "price": 29.99}
When json_schema is provided, the API also adds a structural tag for guided decoding of the JSON output, constraining it to match your schema. If the model doesn’t return valid JSON (e.g., it’s still navigating), the parsed_json field will not be present in the response.

​
Differences from n1

Featuren1n1.5
JSON structured outputNot supportedjson_schema param with parsed_json response
Tool setsFixedSelectable (browser_tools_core-*, browser_tools_expanded-*)
disable_toolsNot supportedSupported
Additional tools—hold_key, middle_click, mouse_down, mouse_up, go_forward
Mouse movehovermouse_move
Key press paramkey_comb (Playwright names)key (lowercase key space)
Click modifiersNot supportedref, modifier params
type extraspress_enter_after, clear_before_typingNot included