How to Use Qwen3-VL 8B Instruct in Windsurf
Use Qwen3-VL 8B Instruct to read document images, extract text, and turn screenshots into HTML. Unlike Qwen3-VL 8B Thinking, it uses non-thinking instruction tuning; Qwen reports stronger complex visual reasoning from its Thinking models.
Prompts to try with Qwen3-VL 8B Instruct in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Qwen3-VL 8B Instruct to turn the reference screenshot in this project into an HTML and CSS draft. Follow the project's existing component conventions and list details the screenshot leaves unclear.
Use Qwen3-VL 8B Instruct to read the chart image in this project and draft a Python plotting script. Preserve visible labels and distinguish printed data from estimated points.
Use Qwen3-VL 8B Instruct to compare the project's reference and current screenshots, labeled A and B. List visible differences in text, controls, and spacing before proposing code changes.
Use Qwen3-VL 8B Instruct to transcribe the document image in this project into Markdown. Preserve heading order and mark unreadable text instead of completing it.
Use Qwen3-VL 8B Instruct to inspect the supplied application screenshot and draft a test checklist for its visible controls. Separate what the screen shows from behavior that needs a running application to verify.
How to set up Qwen3-VL 8B Instruct in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf 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 Qwen3-VL 8B Instruct
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": "qwen/qwen3-vl-8b-instruct", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: Windsurf finds Qwen3-VL 8B Instruct on Spiral, shows the price and runs it.
Qwen3-VL 8B Instruct providers and prices
Spiral runs Qwen3-VL 8B Instruct through OpenRouter. Open a card for today's price, with every fee included.
Up to $0.004006 per run at the default inputs. $0.325 per 1M input tokens, $0.975 per 1M output tokens.
Settings you can ask for
Ask Windsurf 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 235929 | 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 Qwen: Qwen3 VL 8B Instruct is on its tool page: open its card above.
What can you do with Qwen3-VL 8B Instruct in Windsurf?
Turn screenshots and chart images into code you can revise in your project. Qwen3-VL 8B Instruct can draft HTML, plotting scripts, and explanations of visible interface controls.
Multilingual text transcription
Transcribe photographed signs, labels, or document passages. Ask for the original wording and mark any unreadable text explicitly.
Document field extraction
Extract named fields from document images into a consistent record. Specify what to return when a requested value is missing.
Document layout reconstruction
Turn a page image into an outline that preserves headings, text blocks, and their positions on the page.
Screenshot-to-HTML drafts
Convert a screenshot or hand-drawn interface sketch into an HTML draft for a developer to inspect and revise.
Chart reproduction scripts
Generate plotting code from a chart image. Request visible labels and distinguish printed values from estimates.
Interface walkthroughs
Read a screen's visible controls and draft instructions for a stated task. Ask the model to stop where the next screen would be needed.
Screenshot comparison reports
Label screenshots A and B, then request a comparison of their visible text, controls, and layout.
More on Qwen3-VL 8B Instruct and Windsurf
Overview
Qwen3-VL 8B Instruct in other agents
Questions about Qwen3-VL 8B Instruct in Windsurf
Can Windsurf use Qwen3-VL 8B Instruct?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Qwen3-VL 8B Instruct like any built-in tool.
How much does Qwen3-VL 8B Instruct cost in Windsurf?
Up to $0.004006 per run at the default inputs. $0.325 per 1M input tokens, $0.975 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need an OpenRouter account to use Qwen3-VL 8B Instruct in Windsurf?
No. Spiral runs Qwen3-VL 8B Instruct on its own OpenRouter account. You sign in to Spiral once and never paste a key.
How long does it take to set up Qwen3-VL 8B Instruct in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Qwen3-VL 8B Instruct runs?
Qwen3-VL 8B Instruct runs in the background. Windsurf starts the run, checks on it and gives you the text, json when it's ready.
What is Qwen3-VL 8B Instruct useful for?
Useful tasks include reading document images, extracting text, interpreting interface screenshots, and drafting HTML from a screenshot. Qwen also demonstrates generating plotting code from chart images.
How many languages does its OCR support?
Qwen documents OCR support for 32 languages. That count describes text recognition, not a guarantee of equal accuracy across languages.
Can it turn a screenshot into code?
Yes. Qwen demonstrates converting screenshots and sketches into HTML, plus generating plotting code from chart images.
How much context does it have, and how long can its answers be?
The published model configuration specifies 262,144 context tokens. Qwen uses up to 32,768 output tokens in its Instruct text evaluations, but that setting does not establish a universal answer-length limit.
Where is Qwen3-VL 8B Instruct weaker than Thinking models?
Complex visual reasoning is a relative weakness: Qwen reports stronger multimodal reasoning from its Thinking models. For difficult problems with several reasoning steps, treat an Instruct answer as a draft to verify.
Start using Qwen3-VL 8B Instruct in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


