How to Use Ideogram Upscale in Claude 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.
Prompts to try with Ideogram Upscale in Claude Code
Copy an example into Claude Code, or ask in your own words.
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 Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Ideogram Upscale
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/upscale", "input": { "image_url": "https://fal.media/files/monkey/e6RtJf_ue0vyWzeiEmTby.png" } }'
Then paste one of the prompts above: Claude Code finds Ideogram Upscale on Spiral, shows the price and runs it.
Ideogram Upscale providers and prices
Spiral runs Ideogram Upscale through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Ideogram Upscale works from your image URL and prompt. Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| 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 | on or off | off | Whether to expand the prompt with MagicPrompt functionality. |
| Seed | a whole number | Seed for the random number generator |
Every API field of Ideogram Upscale is on its tool page: open its card above.
What can you do with Ideogram Upscale in Claude 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.
More on Ideogram Upscale and Claude Code
Overview
Ideogram Upscale in other agents
Questions about Ideogram Upscale in Claude Code
Can Claude Code use Ideogram Upscale?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Ideogram Upscale like any built-in tool.
How much does Ideogram Upscale cost in Claude 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 Claude Code plan is separate.
Do I need a fal account to use Ideogram Upscale in Claude 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 Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Ideogram Upscale runs?
Ideogram Upscale runs in the background. Claude 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.
Start using Ideogram Upscale in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


