[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Gemini 3.8 Flash](https://spiral.ai/integrations/windsurf/gemini-3-8-flash)

# How to Use Gemini 3.8 Flash in Windsurf

Gemini 3.8 Flash suits code changes across multiple files, document analysis, and tasks that need several reasoning steps. Google reports stronger software engineering and reasoning than Gemini 3.7 Flash, with greater token use possible on difficult work.

|  |  |
| --- | --- |
| Model | Gemini 3.8 Flash |
| Available through | Vertex AI, Gemini |
| Category | LLM |
| Price | Up to $0.040005 per run at the default inputs. $1.95 per 1M input tokens, $0.195 per 1M cached input tokens, $0.054166668 per 1M cache write tokens, $9.75 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Gemini 3.8 Flash in Windsurf

- Use Gemini 3.8 Flash to trace authentication through this project. Identify where expired sessions are handled, propose the smallest consistent fix, and run the relevant tests after making it.
- Use Gemini 3.8 Flash with high reasoning effort to investigate duplicate processing during retries. Trace the relevant code, reproduce the failure, and add a regression test with the fix.
- Use Gemini 3.8 Flash to replace the duplicated date parsing in this project with one shared implementation. Preserve existing behavior and check every caller.
- Use Gemini 3.8 Flash to compare the API implementation with the project's documented contract. Return a table of mismatches with file locations and a focused test for each confirmed issue.
- Use Gemini 3.8 Flash to review this branch for behavior changes. Explain the affected paths, identify missing regression coverage, and keep the review under 800 words.

## How to set up Gemini 3.8 Flash in Windsurf

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

### Use Spiral's MCP server

1. **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:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **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.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Gemini 3.8 Flash**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "vertex",
    "model": "google/gemini-3.8-flash",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Gemini 3.8 Flash on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## Gemini 3.8 Flash tools and prices

- [Gemini 3.8 Flash](https://spiral.ai/tools/vertex/google/gemini-3.8-flash) (Vertex AI): Up to $0.040005 per run at the default inputs. $1.95 per 1M input tokens, $0.195 per 1M cached input tokens, $0.054166668 per 1M cache write tokens, $9.75 per 1M output tokens.
- [Gemini 3.8 Flash Media Understanding (image, video, audio, PDF)](https://spiral.ai/tools/gemini/gemini-3.8-flash) (Gemini): Up to $2.6837 per run at the default inputs. $1.95 per 1M input tokens, $0.195 per 1M cached input tokens, $9.75 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| stop |  | — |  |
| tools |  | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 1 to 65536 | — | The most output tokens to generate. |
| tool_choice |  | — |  |

## What can you do with Gemini 3.8 Flash in Windsurf?

Gemini 3.8 Flash can help carry code changes across multiple files and investigate bugs that span several modules. Give it a concrete acceptance test and have it check the completed change.

### Refactor code across files

Use Gemini 3.8 Flash to trace a change through related modules, update callers, and check the result with focused tests.

### Investigate difficult bugs

Give Gemini 3.8 Flash the relevant code and failure details. Ask for a reproducible explanation, a small fix, and a regression check.

### Compare lengthy documents

Ask Gemini 3.8 Flash to compare supplied document text, identify conflicting requirements, and cite the passages behind each finding.

### Extract records from text

Use Gemini 3.8 Flash to turn order notes or meeting summaries into structured records, with explicit rules for missing information.

### Triage incoming requests

Ask Gemini 3.8 Flash to classify request text, summarize the issue, and draft the next question using a fixed set of categories.

### Review analytical reports

Have Gemini 3.8 Flash examine supplied figures and explanations, flag unsupported conclusions, and list calculations that need an independent check.

## Overview

- [Google Vertex AI](https://spiral.ai/providers/vertex)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## Gemini 3.8 Flash in other agents

- [Amp](https://spiral.ai/integrations/amp/gemini-3-8-flash)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/gemini-3-8-flash)
- [Claude](https://spiral.ai/integrations/claude-desktop/gemini-3-8-flash)
- [Claude Code](https://spiral.ai/integrations/claude-code/gemini-3-8-flash)
- [Cline](https://spiral.ai/integrations/cline/gemini-3-8-flash)
- [Codex](https://spiral.ai/integrations/codex/gemini-3-8-flash)
- [Cursor](https://spiral.ai/integrations/cursor/gemini-3-8-flash)
- [Devin](https://spiral.ai/integrations/devin/gemini-3-8-flash)
- [dots](https://spiral.ai/integrations/dots/gemini-3-8-flash)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/gemini-3-8-flash)
- [Gemini](https://spiral.ai/integrations/gemini/gemini-3-8-flash)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/gemini-3-8-flash)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/gemini-3-8-flash)
- [goose](https://spiral.ai/integrations/goose/gemini-3-8-flash)
- [Grok](https://spiral.ai/integrations/grok/gemini-3-8-flash)
- [Grok Build](https://spiral.ai/integrations/grok-build/gemini-3-8-flash)
- [Hermes](https://spiral.ai/integrations/hermes/gemini-3-8-flash)
- [Instinct](https://spiral.ai/integrations/instinct/gemini-3-8-flash)
- [Manus](https://spiral.ai/integrations/manus/gemini-3-8-flash)
- [Muse](https://spiral.ai/integrations/muse/gemini-3-8-flash)
- [Muse Code](https://spiral.ai/integrations/muse-code/gemini-3-8-flash)
- [n8n](https://spiral.ai/integrations/n8n/gemini-3-8-flash)
- [Notion](https://spiral.ai/integrations/notion/gemini-3-8-flash)
- [OpenClaw](https://spiral.ai/integrations/openclaw/gemini-3-8-flash)
- [opencode](https://spiral.ai/integrations/opencode/gemini-3-8-flash)
- [Perplexity](https://spiral.ai/integrations/perplexity/gemini-3-8-flash)
- [Raycast](https://spiral.ai/integrations/raycast/gemini-3-8-flash)
- [VS Code](https://spiral.ai/integrations/vscode/gemini-3-8-flash)
- [Zapier](https://spiral.ai/integrations/zapier/gemini-3-8-flash)

## More Windsurf guides

- [Gemini 3.7 Flash](https://spiral.ai/integrations/windsurf/gemini-3-7-flash)
- [Gemini 4 Argon](https://spiral.ai/integrations/windsurf/gemini-4-argon)
- [Gemini 3.5 Flash-Lite](https://spiral.ai/integrations/windsurf/gemini-3-5-flash-lite)
- [Gemini 4 Carbon](https://spiral.ai/integrations/windsurf/gemini-4-carbon)
- [Gemini 3.5 Flash](https://spiral.ai/integrations/windsurf/gemini-3-5-flash)
- [Gemini 4 Carbon Batch](https://spiral.ai/integrations/windsurf/gemini-4-carbon-batch)

## Questions about Gemini 3.8 Flash in Windsurf

**Can Windsurf use Gemini 3.8 Flash?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Gemini 3.8 Flash like any built-in tool.

**How much does Gemini 3.8 Flash cost in Windsurf?**

Up to $0.040005 per run at the default inputs. $1.95 per 1M input tokens, $0.195 per 1M cached input tokens, $0.054166668 per 1M cache write tokens, $9.75 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 a Vertex AI account to use Gemini 3.8 Flash in Windsurf?**

No. Spiral runs Gemini 3.8 Flash on its own Vertex AI account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Gemini 3.8 Flash in Windsurf?**

About two minutes: add the server, then sign in, then check it.

**Which provider runs Gemini 3.8 Flash?**

Spiral offers Gemini 3.8 Flash through Vertex AI and Gemini. Name one in your prompt, or let Windsurf pick.

**Does Windsurf wait while Gemini 3.8 Flash runs?**

Gemini 3.8 Flash runs in the background. Windsurf starts the run, checks on it and gives you the text, json when it's ready.

**What is Gemini 3.8 Flash good at?**

It is designed for software engineering, agent tasks, and analysis that takes several reasoning steps. Google reports improvements over Gemini 3.7 Flash in these areas.

**How much text can Gemini 3.8 Flash handle?**

Google lists an input limit of 1,048,576 tokens and an output limit of 65,536 tokens. For a long report, specify the sections and desired length instead of asking it to fill the available space.

**When should I increase reasoning effort?**

Use high effort for difficult mathematics or analysis with several dependent steps. Low effort suits quick drafts and simpler analysis; higher effort can increase token use.

**Can Gemini 3.8 Flash return structured data?**

Yes, it supports structured outputs with a JSON Schema. Define the information you need and how missing values should appear, then validate the extracted values against the source.

**What should I check before trusting an answer?**

Gemini 3.8 Flash can hallucinate. Check citations, calculations, and code behavior, and ask it to distinguish evidence from assumptions.

