Spiral gives your agent every tool with one account. Browse the tools →

n8n · LLMReleased 2025-07-22

How to Use UI-TARS 1.5 7B in n8n

UI-TARS 1.5 7B turns screenshots and task instructions into mouse and keyboard actions for computer workflows. Unlike the higher-performing UI-TARS 1.5 research model, it focuses on general computer use and is not optimized for games.

Prompts to try with UI-TARS 1.5 7B in n8n

Copy an example into n8n, or ask in your own words.

Every morning, use UI-TARS 1.5 7B with current browser screenshots to open the Reports page and select Yesterday. Work one action at a time and stop when that view is visible.

UI-TARS 1.5 7Bn8n
Try asking
  • Each weekday, use UI-TARS 1.5 7B to check the staging site's search flow. Search for backpack, select the available-items filter, and report whether the expected filtered view appears.

  • Every Monday, use UI-TARS 1.5 7B to navigate the reporting dashboard to the Weekly tab. Include the action history with each new screenshot and stop when the tab is selected.

  • At the start of each workday, use UI-TARS 1.5 7B to prepare the visible status form with the text Daily review pending. Use the least random generation setting and stop before submitting.

  • Each evening, use UI-TARS 1.5 7B to check the staging app's notification preferences flow. Request one mouse or keyboard action per screenshot and report whether the preferences panel opens.

How to set up UI-TARS 1.5 7B in n8n

Pick the way that suits you. Each takes about two minutes.

Use the Spiral skill

  1. Send n8n this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use Spiral's MCP server

  1. Create a key

    Create a key under API keys in the console.

  2. Add an MCP Client node

    In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

    https://api.spiral.ai/mcp
  3. Pick a tool

    The node lists Spiral's tools. In an MCP Client node pick one, such as run, and give it its arguments:

    {
      "provider": "fal",
      "model": "fal-ai/flux/schnell",
      "input": { "prompt": "a lighthouse at dawn" },
      "wait": true
    }
  4. Run UI-TARS 1.5 7B in a workflow step

    Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds UI-TARS 1.5 7B, prices it and runs it each time the step fires.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run UI-TARS 1.5 7B

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "openrouter",
        "model": "bytedance/ui-tars-1.5-7b",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: n8n finds UI-TARS 1.5 7B on Spiral, shows the price and runs it.

UI-TARS 1.5 7B providers and prices

Spiral runs UI-TARS 1.5 7B through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
ByteDance: UI-TARS 7B
bytedance/ui-tars-1.5-7b

Settings you can ask for

Ask n8n for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Top ka whole number from 0
Top p0 to 1
Logprobson or off
Max tokens1 to 2048

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Presence penalty-2 to 2
Frequency penalty-2 to 2
Repetition penalty0 to 2

Every API field of ByteDance: UI-TARS 7B is on its tool page: open its card above.

What can you do with UI-TARS 1.5 7B in n8n?

UI-TARS 1.5 7B can supply screen-based actions for scheduled interface checks and recurring navigation tasks. Define a visible finish condition and have the agent evaluate a fresh screenshot after each executed action.

Find a control in a screenshot

Ask UI-TARS 1.5 7B to locate a named button or menu item and return only the next click action.

Test a browser workflow

Use screenshots and action history to work through a search, filter, or form flow. Check the screen after each action against the expected result.

Navigate desktop settings

Give UI-TARS 1.5 7B a specific destination, such as a display settings panel, and request the next mouse or keyboard action.

Prepare a form draft

Supply the visible form and exact text to enter. Request actions to fill the fields and stop before submission.

Work through an office interface

Use visible menus, clicks, typing, and keyboard shortcuts to guide a bounded task in a spreadsheet or document editor.

Navigate a file manager

Provide a screenshot and a target folder name. Request the next action to reach that folder, with a new screenshot after navigation.

Questions about UI-TARS 1.5 7B in n8n

Can n8n use UI-TARS 1.5 7B?

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run UI-TARS 1.5 7B like any built-in tool.

How much does UI-TARS 1.5 7B cost in n8n?

Up to $0.000539 per run at the default inputs. $0.13 per 1M input tokens, $0.26 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your n8n plan is separate.

Do I need an OpenRouter account to use UI-TARS 1.5 7B in n8n?

You need no OpenRouter account. n8n uses one Spiral API key for every tool, and Spiral runs UI-TARS 1.5 7B on its own OpenRouter account.

How long does it take to set up UI-TARS 1.5 7B in n8n?

About two minutes: create a key, then add an MCP Client node, then pick a tool.

Does n8n wait while UI-TARS 1.5 7B runs?

UI-TARS 1.5 7B runs in the background. n8n starts the run, checks on it and gives you the text, json when it's ready.

What is UI-TARS 1.5 7B useful for?

It is designed for computer tasks that involve reading a screen and choosing mouse or keyboard actions. Practical uses include navigating forms, finding controls, and working through desktop interfaces.

What does UI-TARS 1.5 7B return?

The documented computer-use format has Thought and Action sections. For locating a target on screen, the grounding prompt requests an action alone.

What should I include in a UI-TARS 1.5 7B prompt?

Supply the task, a current screenshot, and the preceding action history. Ask for the next action toward a concrete result, such as opening a particular settings panel.

Is UI-TARS 1.5 7B optimized for games?

ByteDance says the released 7B model focuses on general computer use and is not specifically optimized for games. The stronger game results described for UI-TARS 1.5 should not be attributed to the 7B model.

Which generation settings are a useful starting point?

ByteDance's example uses temperature 0 and a 400-token output budget. Treat those as starting values for short action responses, rather than a statement of the model's maximum output length.

Get started

Start using UI-TARS 1.5 7B in n8n

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into n8n:

Set up n8n

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options