[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Ideogram Upscale](https://spiral.ai/integrations/muse-code/ideogram-upscale)

# How to Use Ideogram Upscale in Muse Code

Ideogram Upscale enlarges an existing image by up to 2x, with an optional prompt to guide improvements. Use it to prepare a larger version of an approved image, with control over resemblance and added detail.

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

## Prompts to try with Ideogram Upscale in Muse Code

- Use Ideogram Upscale on the homepage photograph in this project, enlarging it by up to 2x without a guidance prompt. Save a separate copy and report its dimensions.
- Use Ideogram Upscale on the product illustration in this project's assets. Keep detail fixed, compare two resemblance settings, and create a side-by-side review.
- Use Ideogram Upscale on the food photograph used by the menu page. Guide it with 'plated pasta with basil and grated cheese,' leave prompt expansion off, and save the result for review.
- Use Ideogram Upscale on the promotional artwork in this project. Compare every visible word with the original and flag differences before changing any asset references.
- Use Ideogram Upscale to compare two detail settings on the landscape image in this project. Keep resemblance and the guidance prompt unchanged, and show both results beside the source.

## How to set up Ideogram Upscale in Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse 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 Ideogram Upscale**: 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/upscale",
    "input": {
      "image_url": "https://fal.media/files/monkey/e6RtJf_ue0vyWzeiEmTby.png"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds Ideogram Upscale on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## Ideogram Upscale tools and prices

- [Ideogram Upscale](https://spiral.ai/tools/fal/fal-ai/ideogram/upscale) (fal): $0.078 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  |  | The prompt to upscale the image with |
| resemblance | 1 to 100 | 50 | The resemblance of the upscaled image to the original image |
| detail | 1 to 100 | 50 | The detail of the upscaled image |
| expand_prompt |  | false | Whether to expand the prompt with MagicPrompt functionality. |
| seed |  | — | Seed for the random number generator |

## What can you do with Ideogram Upscale in Muse Code?

Ideogram Upscale lets a coding agent prepare larger copies of existing project images. Have the agent compare outputs with the originals before replacing approved assets.

### Website image enlargement

Enlarge an approved website image by up to 2x for a larger placement. Compare the result with the original before replacing it.

### Poster artwork preparation

Make a larger copy of existing poster artwork. Check the resulting dimensions against the printer's requirements and proofread any lettering.

### Product photo review

Enlarge a product photo for closer inspection. Review the result against the source before approving packaging details or labels.

### Illustration enlargement

Prepare a larger copy of an existing illustration. Compare resemblance and detail settings before choosing the result.

### Social image reuse

Enlarge an existing campaign image for a larger placement with the same aspect ratio. Review embedded text before publication.

### Guided texture experiments

Use an existing image and a descriptive prompt to explore detail improvements. Compare each result with an enlargement made without a prompt.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## Ideogram Upscale in other agents

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

## More Muse Code guides

- [Ideogram Remove Background](https://spiral.ai/integrations/muse-code/ideogram-remove-background)
- [Ideogram Vector](https://spiral.ai/integrations/muse-code/ideogram-vector)
- [Ideogram Object Removal](https://spiral.ai/integrations/muse-code/ideogram-object-removal)
- [Ideogram Vector Image to SVG](https://spiral.ai/integrations/muse-code/ideogram-vector-image-to-svg)
- [Ideogram 4.5 Text to Image](https://spiral.ai/integrations/muse-code/ideogram-4-5-text-to-image)
- [Image Apps v2 Relighting](https://spiral.ai/integrations/muse-code/image-apps-v2-relighting)

## Questions about Ideogram Upscale in Muse Code

**Can Muse Code use Ideogram Upscale?**

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

**How much does Ideogram Upscale cost in Muse Code?**

$0.078 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Muse Code plan is separate.

**Do I need a fal account to use Ideogram Upscale in Muse Code?**

No. Spiral runs Ideogram Upscale 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 Upscale in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Ideogram Upscale runs?**

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

**What is Ideogram Upscale useful for?**

Use it when you already have an image you like and need a larger version. An optional prompt can guide improvements during enlargement.

**How much can Ideogram Upscale enlarge an image?**

The endpoint supports up to 2x enlargement. Keep that limit in mind when planning the final image size.

**Does Ideogram Upscale need a prompt?**

No. Try the image without a prompt first, then add a short description of the subject and desired detail if you want guided improvements.

**How should I balance resemblance and detail?**

Use resemblance to control similarity to the source and detail to control the enlarged image's detail. Compare results while changing one control at a time.

**Can Ideogram Upscale change an image's shape?**

Upscaling keeps the original aspect ratio. Crop or extend the image separately if you need a different composition.

