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

Windsurf · Image

How to Use Ideogram 2.0 in Windsurf

Ideogram 2.0 creates posters, logo concepts, and realistic images from a written brief. Unlike Ideogram 2.0 Remix, it starts from text alone.

Prompts to try with Ideogram 2.0 in Windsurf

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

Read the brand brief in this project, then use Ideogram 2.0 to create a square logo concept for "Northline" in Design style. Use a simple mountain symbol and check the lettering against the brief.

Ideogram 2.0Windsurf
Try asking
  • Generate a product photo with Ideogram 2.0: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.

  • Make four logo concepts for a coffee brand called "Northline" with Ideogram 2.0.

  • Create a 16:9 hero image of a quiet mountain cabin at dusk with Ideogram 2.0.

  • Generate a 9:16 poster with Ideogram 2.0 for a jazz night called "Blue Hour", deep navy and brass tones.

How to set up Ideogram 2.0 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:

    {
      "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.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Ideogram 2.0

    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/ideogram/v2",
        "input": {
          "prompt": "A comic style illustration of a skeleton sitting on a toilet in a bathroom. The bathroom has a Halloween decoration with a pumpkin jack-o-lantern and bats…"
        }
      }'

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

Ideogram 2.0 providers and prices

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

falImage

Settings you can ask for

Ideogram 2.0 works from your prompt. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Aspect ratio10:16, 16:10, 9:16, 16:9, 4:3, 3:4, 1:1, 1:3 and 3 more1:1

The aspect ratio of the generated image

Expand prompton or offon

Whether to expand the prompt with MagicPrompt functionality.

Seeda whole number

Seed for the random number generator

Styleauto, general, realistic, design, render_3D, or animeauto

The style of the generated image

Negative promptwhat to leave out, in words

A negative prompt to avoid in the generated image

Every API field of Ideogram V2 · Text to Image is on its tool page: open its card above.

What can you do with Ideogram 2.0 in Windsurf?

Turn a project's visual brief into poster, logo, and lettering concepts. Use the agent to compare drafts against the project's wording and identify text that needs another pass.

Event poster concepts

Develop a poster with a short event name and a clear visual theme. Create the first draft from a brief, reinterpret existing artwork with Remix, or revise a masked headline with Edit.

Logo concept exploration

Explore a short brand name with a simple symbol. Generate initial directions from text, remix an existing concept, or mask the lettering for a focused revision.

Typography studies

Compare treatments of a short phrase in a poster composition. Start from a written brief, reinterpret an existing study, or edit the selected lettering area.

Promotional graphic drafts

Build a campaign graphic around a short message such as "Open Studio". Generate a new composition, remix approved artwork into another direction, or replace a masked message.

Realistic image concepts

Create realistic image drafts from a description for an editorial or campaign brief. Compare compositions before choosing an image to develop further.

Questions about Ideogram 2.0 in Windsurf

Can Windsurf use Ideogram 2.0?

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

How much does Ideogram 2.0 cost in Windsurf?

$0.104 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 Ideogram 2.0 in Windsurf?

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

How long does it take to set up Ideogram 2.0 in Windsurf?

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

Does Windsurf wait while Ideogram 2.0 runs?

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

What is Ideogram 2.0 useful for?

Start with posters, logo concepts, and images where lettering is part of the design. Realistic imagery is another supported use.

How do I ask for specific words in an image?

Put the exact wording in quotation marks. For example, ask for a poster with the headline "Night Market" rather than asking the model to invent a headline.

Can I rely on every word being spelled correctly?

Check the result before using it. Short headlines give you fewer opportunities for missing letters or typos than paragraphs.

Which style should I try for lettering?

Try Design when the words are central to the image. Ideogram says this style improves text accuracy in Ideogram 2.0.

Is Ideogram 2.0 suitable for logo work?

It is a useful starting point for logo concepts and lettering exploration. Give each draft a short name, then inspect the generated letters before choosing a direction.

Get started

Start using Ideogram 2.0 in Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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