[Integrations](https://spiral.ai/integrations) › [Claude](https://spiral.ai/integrations/claude-desktop) › [Ideogram 3.0](https://spiral.ai/integrations/claude-desktop/ideogram-3-0)

# How to Use Ideogram 3.0 in Claude

Ideogram 3.0 makes images with text built into the design, including posters, logos, and promotional graphics. In Claude, start with the exact wording and a clear visual brief, then check every letter before publishing.

|  |  |
| --- | --- |
| Model | Ideogram 3.0 |
| Available through | fal |
| Category | Image |
| Price | $0.039 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 Ideogram 3.0 in Claude

- Use Ideogram Text to Image to make three poster concepts for a neighborhood plant swap. Put "PLANT SWAP" in large lettering at the top and "BRING ONE, TAKE ONE" below an illustration of potted plants. Choose the Design style, use dark green and pale yellow, and turn prompt optimization off.
- Use Ideogram Text to Image to create four thumbnail concepts with the exact headline "SMALL ROOM, BIG IDEAS". Put the headline on the left and a compact home office on the right. Use thick white lettering against a dark background. Turn prompt optimization off and exclude extra captions.
- Use Ideogram Text to Image with the image I shared as a style reference. Make a promotional graphic showing a bicycle beside a storefront, with "SATURDAY RIDE" across the top. Keep the image description short and turn prompt optimization off so the reference guides the look.
- Use Ideogram Text to Image to create three promotional graphics for a fictional coffee brand called "NORTH WINDOW". Show a coffee bag on a wooden counter with the brand name on its label. Choose the Realistic style and use soft window light. Keep the wording identical across all three candidates.
- Generate a product photo with Ideogram 3.0: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first.

## How to set up Ideogram 3.0 in Claude

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

### Use the Claude connector

1. **Add Spiral to Claude**: Click Add Spiral in Claude above. Claude opens Add custom connector with Spiral and its URL filled in; check them and click Continue. Without the link: in Claude open Customize › Connectors › Add › Add custom connector and paste this URL:

```text
https://api.spiral.ai/mcp
```

2. **Keep the detected sign-in and click Add**: Claude finds Spiral's sign-in by itself: leave Sign in now and Use Claude's published identity selected.

3. **Click Connect**: The connector page opens. Connect takes you to Spiral in your browser.

### Use the Spiral skill

1. **Send Claude 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 Ideogram 3.0**: 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/ideogram/v3",
    "input": {
      "prompt": "The Bone Forest stretched across the horizon, its trees fashioned from the ossified remains of ancient leviathans that once swam through the sky. Shamans with…"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-desktop

## Ideogram 3.0 tools and prices

- [Ideogram Text to Image](https://spiral.ai/tools/fal/fal-ai/ideogram/v3) (fal): $0.039 per image with TURBO, $0.078 with BALANCED (the default), $0.117 with QUALITY.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_urls |  | — | A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format |
| rendering_speed | TURBO, BALANCED, QUALITY | BALANCED | The rendering speed to use. |
| color_palette |  | — | A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members) |
| style_codes |  | — | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style |
| style | AUTO, GENERAL, REALISTIC, DESIGN | — | The style type to generate with. Cannot be used with style_codes. |
| expand_prompt |  | true | Determine if MagicPrompt should be used in generating the request or not. |

## What can you do with Ideogram 3.0 in Claude?

Use Claude to turn your campaign idea into a brief with a headline, lettering direction, colors, and composition. Ask for a few design candidates, then change one detail per round so you can compare the results.

### Event posters

Bring an event idea and approved headline into the conversation. Request several poster directions with specific text placement, then check the lettering before adding the final event details.

### Thumbnail concepts

Pair a short headline with one clear subject. Compare a few compositions while keeping the wording fixed, then choose which direction to develop.

### Campaign graphics with a shared look

Supply a style reference and request a new promotional graphic for each campaign message. Review the candidates together for visual consistency and spelling.

### Packaging concepts

Explore how a fictional brand name looks on a coffee bag, bottle, or box. Specify the setting and lighting to compare different product photography directions.

### Headline design exploration

Take one approved phrase and request several lettering treatments. Keep the message fixed while testing its size, placement, and relationship to the illustration.

### Social promotion drafts

Turn a campaign brief into graphic candidates with a short offer or announcement. Review the wording and composition before preparing the selected design for publication.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Claude guides](https://spiral.ai/integrations/claude-desktop)

## More Claude guides

- [Ideogram 2a Turbo Remix](https://spiral.ai/integrations/claude-desktop/ideogram-2a-turbo-remix)
- [Ideogram 3.0 Character](https://spiral.ai/integrations/claude-desktop/ideogram-3-0-character)
- [Ideogram 2a Turbo](https://spiral.ai/integrations/claude-desktop/ideogram-2a-turbo)
- [Ideogram 3.0 Character Edit](https://spiral.ai/integrations/claude-desktop/ideogram-3-0-character-edit)
- [Ideogram 2a Remix](https://spiral.ai/integrations/claude-desktop/ideogram-2a-remix)
- [Ideogram 3.0 Character Remix](https://spiral.ai/integrations/claude-desktop/ideogram-3-0-character-remix)

## Questions about Ideogram 3.0 in Claude

**Can Claude use Ideogram 3.0?**

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

**How much does Ideogram 3.0 cost in Claude?**

$0.039 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 Claude plan is separate.

**Do I need a fal account to use Ideogram 3.0 in Claude?**

No. Spiral runs Ideogram 3.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 3.0 in Claude?**

About two minutes: add Spiral to Claude, then keep the detected sign-in and click Add, then click Connect.

**Does Claude wait while Ideogram 3.0 runs?**

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

**How do I get Ideogram 3.0 to spell text correctly?**

Put the exact words in quotation marks near the beginning of the brief and keep the phrase short. Check every letter in the result before publishing.

**Can Ideogram 3.0 generate text in languages other than English?**

English is the most reliable choice for text inside images. Non-Latin scripts and accented letters can render incorrectly or be omitted, so review those results closely.

**Can Ideogram 3.0 follow the style of an existing image?**

Yes. Style references guide the look of a new image; use them when you have a visual example of the aesthetic you want.

**Should I turn Magic Prompt off in Ideogram 3.0?**

Turn it off when you want to test your exact brief. Magic Prompt expands the description, so leaving it on introduces additional detail.

**Will the same seed reproduce an identical Ideogram 3.0 image?**

An identical image or layout is not guaranteed. Use a fixed seed as a comparison aid, and inspect each result.

