[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [YouTube Thumbnails](https://spiral.ai/integrations/windsurf/youtube-thumbnails)

# How to Use YouTube Thumbnails in Windsurf

YouTube Thumbnails makes thumbnail artwork with custom headline text. Its style-strength control lets you compare different strengths of the thumbnail treatment.

|  |  |
| --- | --- |
| Model | YouTube Thumbnails |
| Available through | fal |
| Category | Image |
| Price | $0.052 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with YouTube Thumbnails in Windsurf

- Read the README and use YouTube Thumbnails to draft a demo cover with the text 'BUILD IT YOURSELF'. Check whether that headline accurately describes the project.
- Read the release notes and choose the clearest user-facing improvement. Use YouTube Thumbnails to make a cover with a short headline about that improvement.
- Use YouTube Thumbnails to draft a debugging tutorial cover with the text 'FOUND THE BUG'. Save the exact prompt and seed beside the draft in the project.
- Use YouTube Thumbnails to make two separate project walkthrough covers, one reading 'START HERE' and one reading 'FIRST BUILD'. Put them side by side for review.
- Use YouTube Thumbnails to compare three style strengths for a cover reading 'SHIP THE DEMO'. Keep the prompt and seed fixed and label each result.

## How to set up YouTube Thumbnails 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 YouTube Thumbnails**: 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": "fal",
    "model": "fal-ai/image-editing/youtube-thumbnails",
    "input": {
      "image_url": "https://v3.fal.media/files/koala/QUihQrMqowYu30UFC_Atk.png"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds YouTube Thumbnails on Spiral, shows the price and runs it.

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

## YouTube Thumbnails tools and prices

- [Image Editing Youtube Thumbnails · YT Thumbnails](https://spiral.ai/tools/fal/fal-ai/image-editing/youtube-thumbnails) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| guidance_scale | 0 to 20 | 3.5 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |
| num_inference_steps | 1 to 50 | 30 | Number of inference steps for sampling. |
| lora_scale | 0 to 4 | 0.5 | The scale factor for the LoRA model. Controls the strength of the LoRA effect. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| prompt |  | Generate youtube thumbnails | The text to include in the YouTube thumbnail. |

## What can you do with YouTube Thumbnails in Windsurf?

Create thumbnail drafts for project demos and tutorial videos. Use the project's documentation to choose an accurate headline, then compare the artwork.

### Tutorial covers

Draft a thumbnail with a direct teaching headline such as 'FIX YOUR AUDIO'. Review the wording before choosing a cover.

### Product review headlines

Compare thumbnail drafts labeled 'WORTH IT?' and 'ONE MONTH LATER' for a review that answers both questions.

### Project build videos

Create covers for a build series using headlines such as 'FIRST BUILD', 'WHAT BROKE', and 'FINAL RESULT'.

### Experiment recaps

Draft a cover labeled '30 DAY TEST' for a video reporting a completed experiment.

### Interview highlights

Turn a short, accurate interview takeaway into thumbnail text. Compare two headline drafts before selecting one.

### Thumbnail style comparisons

Keep the headline fixed and compare several style strengths. Review the drafts together before picking a treatment.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## YouTube Thumbnails in other agents

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

## More Windsurf guides

- [Wojak Style](https://spiral.ai/integrations/windsurf/wojak-style)
- [Z-Image Base](https://spiral.ai/integrations/windsurf/z-image-base)
- [Weather Effect](https://spiral.ai/integrations/windsurf/weather-effect)
- [Z-Image Base LoRA](https://spiral.ai/integrations/windsurf/z-image-base-lora)
- [Wan 2.7 Text to Image](https://spiral.ai/integrations/windsurf/wan-2-7-text-to-image)
- [Z-Image Turbo](https://spiral.ai/integrations/windsurf/z-image-turbo)

## Questions about YouTube Thumbnails in Windsurf

**Can Windsurf use YouTube Thumbnails?**

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

**How much does YouTube Thumbnails cost in Windsurf?**

$0.052 per image. 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 fal account to use YouTube Thumbnails in Windsurf?**

No. Spiral runs YouTube Thumbnails on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up YouTube Thumbnails in Windsurf?**

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

**Does Windsurf wait while YouTube Thumbnails runs?**

YouTube Thumbnails runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

**What is YouTube Thumbnails designed for?**

It generates YouTube thumbnail artwork with custom text. Use it to draft covers around a specific headline.

**How should I specify the thumbnail headline?**

State the exact words you want displayed, such as: Generate a YouTube thumbnail using the text 'FIRST BUILD'. Keep headline experiments separate so you can review each result.

**What controls how closely it follows my instructions?**

Guidance controls prompt adherence. Compare results while changing that control alone.

**Can I adjust the thumbnail style strength?**

Yes. The LoRA strength control changes how strongly the style effect is applied.

**Can I reproduce a result?**

The documentation says the same seed and prompt reproduce the same image with the same model version. Save those details with a result you want to revisit.

