How to Use UI-TARS 1.5 7B in Factory Droid
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 Factory Droid
Copy an example into Factory Droid, or ask in your own words.
Use UI-TARS 1.5 7B to test this project's search page. Read the expected behavior in the repository, then use browser screenshots to search for headphones and select the in-stock filter, requesting one action at a time.
Use UI-TARS 1.5 7B on the failing checkout screenshot in this project. Locate the Continue button and return only the click action; mark the predicted point on the screenshot for review.
Use UI-TARS 1.5 7B to exercise this project's profile editor with the test data in the repository. Fill the visible fields, stop before saving, and capture the resulting screen.
Use UI-TARS 1.5 7B to reproduce the navigation bug described in this project's issue notes. Supply the current screenshot and action history at each step, and record where the visible result first differs from the expected behavior.
Use UI-TARS 1.5 7B to check this project's settings flow. Start with temperature 0 and a 400-token output budget, request Thought and Action sections, and navigate to notification preferences one action at a time.
How to set up UI-TARS 1.5 7B in Factory Droid
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.
droid mcp add spiral https://api.spiral.ai/mcp --type http
- Sign in
Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.
- Check it
Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.
droid mcp list
Use the Spiral skill
- Send Factory Droid this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: Factory Droid 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.
Up to $0.000539 per run at the default inputs. $0.13 per 1M input tokens, $0.26 per 1M output tokens.
Settings you can ask for
Ask Factory Droid for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Seed | a whole number | ||
| Top k | a whole number from 0 | ||
| Top p | 0 to 1 | ||
| Logprobs | on or off | ||
| Max tokens | 1 to 2048 | The most output tokens to generate. | |
| Temperature | 0 to 2 | ||
| Top logprobs | 0 to 20 | ||
| Presence penalty | -2 to 2 | ||
| Frequency penalty | -2 to 2 | ||
| Repetition penalty | 0 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 Factory Droid?
UI-TARS 1.5 7B can help test a project's interface through screenshots and mouse or keyboard actions. Give it a concrete workflow and inspect the visible result after each step.
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.
More on UI-TARS 1.5 7B and Factory Droid
UI-TARS 1.5 7B in other agents
Questions about UI-TARS 1.5 7B in Factory Droid
Can Factory Droid use UI-TARS 1.5 7B?
Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run UI-TARS 1.5 7B like any built-in tool.
How much does UI-TARS 1.5 7B cost in Factory Droid?
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 Factory Droid plan is separate.
Do I need an OpenRouter account to use UI-TARS 1.5 7B in Factory Droid?
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 Factory Droid?
About two minutes: add the server, then sign in, then check it.
Does Factory Droid wait while UI-TARS 1.5 7B runs?
UI-TARS 1.5 7B runs in the background. Factory Droid 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.
Start using UI-TARS 1.5 7B in Factory Droid
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Factory Droid:
set up https://spiral.ai/SKILL.md


