Spiral gives your agent every tool with one account. Browse the tools →

VS Code · ImageReleased 2025-03-22

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.

Prompts to try with Sana Sprint in VS Code

Copy an example into VS Code, or ask in your own words.

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.

Sana SprintVS Code
Try asking
  • 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:

    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.

    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.

    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.

Sana Sprint providers and prices

Spiral runs Sana Sprint through fal. Open a card for today's price, with every fee included.

falImage
Sana Sprint
fal-ai/sana/sprint

Settings you can ask for

Sana Sprint works from your prompt. Ask VS Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Negative promptwhat to leave out, in words

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).

Number of inference steps1 to 202

The number of inference steps to perform.

Seeda whole number

The same seed and the same prompt given to the same version of the model

will output the same image every time.

Guidance scale (CFG)0 to 205

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.

Number of images1 to 41

The number of images to generate.

Output formatjpeg or pngjpeg

The format of the generated image.

Style name(No style), Cinematic, Photographic, Anime, Manga, Digital Art, Pixel art, Fantasy art and 2 more(No style)

The style to generate the image in.

Every API field of Sana Sprint is on its tool page: open its card above.

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.

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.

Get started

Start using Sana Sprint in VS Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into VS Code:

Set up VS Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options