[Integrations](https://spiral.ai/integrations) › [VS Code](https://spiral.ai/integrations/vscode) › [Sana Sprint](https://spiral.ai/integrations/vscode/sana-sprint)

# How to Use Sana Sprint in VS Code

Sana Sprint turns text descriptions into images for concept art, illustrations, and design drafts. Its distinguishing feature is generation in one to four steps; complex lettering and perfect photorealism remain weak points.

|  |  |
| --- | --- |
| Model | Sana Sprint |
| Available through | fal |
| Category | Image |
| Price | $0.00325 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Default 8 MP per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Sana Sprint in VS Code

- Read the project's homepage copy and use Sana Sprint to generate a 1024 × 1024 editorial illustration of its central idea. Use two steps and leave the upper third empty for HTML text.
- Use Sana Sprint to create a 1024 × 1024 environment concept from the game's written level brief: an abandoned observatory above a cloud forest, dawn light, wide view, no lettering. Use two steps.
- Read the project's design notes and use Sana Sprint to draft a 1024 × 1024 illustration for the empty library screen. Show a small reading nook with one lamp and an open book, without visible words.
- Use Sana Sprint to compare one-step, two-step, and four-step renders of the same 1024 × 1024 scene: a ceramic robot tending a rooftop garden. Keep the description unchanged and show the results together.
- Use Sana Sprint to generate two 1024 × 1024 artwork studies for our story game's harbor scene, one in watercolor and one in ink. Keep the viewpoint and objects the same so we can compare the medium.

## How to set up Sana Sprint in VS Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to VS Code on the console's Agents & MCP page, or run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
```

2. **Sign in**: VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

### Use the Spiral skill

1. **Send VS Code 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 Sana Sprint**: 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/sana/sprint",
    "input": {
      "prompt": "Underwater coral reef ecosystem during peak bioluminescent activity, multiple layers of marine life - from microscopic plankton to massive coral structures,…"
    }
  }'
```

Then paste one of the prompts above: VS Code finds Sana Sprint on Spiral, shows the price and runs it.

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

## Sana Sprint tools and prices

- [Sana Sprint](https://spiral.ai/tools/fal/fal-ai/sana/sprint) (fal): $0.00325 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Default 8 MP per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  |  | The negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small details (e.g. moustache, blurry, low resolution). |
| image_size |  | {"width":3840,"height":2160} | The size of the generated image. |
| num_inference_steps | 1 to 20 | 2 | The number of inference steps to perform. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| guidance_scale | 0 to 20 | 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_images | 1 to 4 | 1 | The number of images to generate. |

## What can you do with Sana Sprint in VS Code?

Create candidate artwork for the project while developing its pages or game scenes. The agent can turn written project requirements into image briefs and help assess the results in context.

### Game environment concepts

Use Sana Sprint to explore a fictional location through different lighting, materials, and compositions before committing to production art.

### Editorial illustration drafts

Turn an article's central idea into a visual metaphor, such as a greenhouse representing patient growth. Keep headlines outside the generated artwork.

### Website artwork studies

Generate candidate illustrations for a website and assess their composition in the layout. Request empty space where the page needs readable copy.

### Fictional product concepts

Explore the shape, material, and setting of an invented lamp, chair, or ceramic object before building a physical prototype.

### Story scene exploration

Draft individual scenes from a written story to compare atmosphere and framing. Describe each scene independently.

### Classroom creative exercises

Generate fictional landscapes or visual story starters for writing activities. Add instructions and labels separately.

### Campaign illustration concepts

Explore several visual treatments of a campaign idea before selecting artwork for further editing. Leave slogans and other precise lettering for the final layout.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All VS Code guides](https://spiral.ai/integrations/vscode)

## Sana Sprint in other agents

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

## More VS Code guides

- [Sana 1.5 4.8B](https://spiral.ai/integrations/vscode/sana-1-5-4-8b)
- [Seedream 4.0 Edit](https://spiral.ai/integrations/vscode/seedream-4-0-edit)
- [Sana 1.5 1.6B](https://spiral.ai/integrations/vscode/sana-1-5-1-6b)
- [Seedream 4.0 Text to Image](https://spiral.ai/integrations/vscode/seedream-4-0-text-to-image)
- [Sana](https://spiral.ai/integrations/vscode/sana)
- [Seedream 4.5 Edit](https://spiral.ai/integrations/vscode/seedream-4-5-edit)

## Questions about Sana Sprint in VS Code

**Can VS Code use Sana Sprint?**

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Sana Sprint like any built-in tool.

**How much does Sana Sprint cost in VS Code?**

$0.00325 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Default 8 MP per image. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.

**Do I need a fal account to use Sana Sprint in VS Code?**

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

**How long does it take to set up Sana Sprint in VS Code?**

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

**Does VS Code wait while Sana Sprint runs?**

Sana Sprint runs in the background. VS Code starts the run, checks on it and gives you the image when it's ready.

**What should I use Sana Sprint for?**

Consider it for concept art, editorial illustrations, and visual drafts where you want to explore several directions. Its one-to-four-step design makes iterative image generation a natural use.

**What image size should I start with?**

Start at 1024 × 1024, the size used in NVIDIA's example. The published model is described as 1024-pixel-based; that description does not establish a maximum output size.

**How many inference steps should I use?**

Start with two steps, as NVIDIA's example does, then compare one and four steps on the same brief. Sana Sprint was designed for generation within that range.

**Should I increase guidance to improve the image?**

Higher guidance pushes the result closer to your description, but it can reduce image quality. Try a small adjustment when the result misses an important detail, then compare the images.

**Can Sana Sprint make posters with readable text?**

Complex legible text is a documented limitation. Generate the illustration with room for a headline, then add the lettering in a design editor.

