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

Notion · LLMReleased 2025-07-22

How to Use UI-TARS 1.5 7B in Notion

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 Notion

Copy an example into Notion, 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 7BNotion
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 Notion

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

Use the Spiral skill

  1. Send Notion 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. Allow custom MCP servers

    A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

  2. Add Spiral to a custom agent

    Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

    https://api.spiral.ai/mcp
  3. Sign in to Spiral and approve

    Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

  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: Notion 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 Notion 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 Notion?

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 Notion

Can Notion use UI-TARS 1.5 7B?

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

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

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 Notion plan is separate.

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

No. Spiral runs UI-TARS 1.5 7B on its own OpenRouter account. You sign in to Spiral once and never paste a key.

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

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

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

UI-TARS 1.5 7B runs in the background. Notion 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 Notion

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

Paste this into Notion:

Set up Notion

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