How to Use Ideogram 3.0 Edit in opencode
Ideogram 3.0 Edit repaints a masked area of an existing image, useful for replacing an object or revising lettering. Unlike Ideogram 3.0 Remix, it targets a selected region.
Prompts to try with Ideogram 3.0 Edit in opencode
Copy an example into opencode, or ask in your own words.
Use Ideogram 3.0 Edit on the existing event poster and its matching mask in the project. Replace the masked headline with "OPEN STUDIO" in large block letters. Compare the result with the original before updating the asset.
Remove the background from the photo I attach with Ideogram 3.0 Edit and give me a transparent PNG. Save the result in ./assets.
Use Ideogram 3.0 Edit to clean up these product shots so they sit on pure white.
Edit this image with Ideogram 3.0 Edit: keep the subject, swap the background for a sunlit studio.
Use Ideogram 3.0 Edit to turn this daytime photo into a dusk scene with warm window light.
How to set up Ideogram 3.0 Edit in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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 3.0 Edit
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/v3/edit", "input": { "prompt": "black bag", "image_url": "https://v3.fal.media/files/panda/-LC_gNNV3wUHaGMQT3klE_output.png", "mask_url": "https://v3.fal.media/files/kangaroo/1dd3zEL5MXQ3Kb4-mRi9d_indir%20(20).png" } }'
Then paste one of the prompts above: opencode finds Ideogram 3.0 Edit on Spiral, shows the price and runs it.
Ideogram 3.0 Edit providers and prices
Spiral runs Ideogram 3.0 Edit through fal. Open a card for today's price, with every fee included.
$0.039 per image with TURBO, $0.078 with BALANCED (the default), $0.117 with QUALITY.
Settings you can ask for
Ideogram 3.0 Edit works from your image URLs, prompt, image URL, and mask URL. Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Rendering speed | TURBO, BALANCED, or QUALITY | BALANCED | The rendering speed to use. |
| Expand prompt | on or off | on | Determine if MagicPrompt should be used in generating the request or not. |
| Number of images | 1 to 8 | 1 | Number of images to generate. |
| Seed | a whole number | Seed for the random number generator | |
| Style preset | 80S_ILLUSTRATION, 90S_NOSTALGIA, ABSTRACT_ORGANIC, ANALOG_NOSTALGIA, ART_BRUT, ART_DECO, ART_POSTER, AURA and 54 more | Style preset for generation. The chosen style preset will guide the generation. |
Every API field of Ideogram V3 Edit is on its tool page: open its card above.
What can you do with Ideogram 3.0 Edit in opencode?
Create graphics and short lettering for the interface you are building with Ideogram 3.0. A coding agent can turn project copy and visual requirements into focused briefs, then place reviewed artwork in the project.
Poster refreshes
Start with an existing poster. Repaint a selected illustration or headline area, or remix the complete design to explore another visual treatment.
Product image concepts
Start with a product image and explore another setting or treatment. Use a mask for a selected region, or remix the image for a broader reinterpretation; compare product details with the original.
Book cover revisions
Use an existing cover to explore a different central illustration, color treatment, or title area. Keep long descriptions and fine print in a separate design tool.
Thumbnail revisions
Rework an existing thumbnail with a simpler focal subject and a short headline. Mask the area to revise, or remix the whole composition for another direction.
More on Ideogram 3.0 Edit and opencode
Overview
Ideogram 3.0 Edit in other agents
Questions about Ideogram 3.0 Edit in opencode
Can opencode use Ideogram 3.0 Edit?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Ideogram 3.0 Edit like any built-in tool.
How much does Ideogram 3.0 Edit cost in opencode?
$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 opencode plan is separate.
Do I need a fal account to use Ideogram 3.0 Edit in opencode?
No. Spiral runs Ideogram 3.0 Edit 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 Edit in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Ideogram 3.0 Edit runs?
Ideogram 3.0 Edit runs in the background. opencode starts the run, checks on it and gives you the image when it's ready.
What is Ideogram 3.0 good at?
Graphics that combine imagery with short, readable lettering are a useful starting point: logo concepts, headlines, badges, and promotional artwork. It also handles realistic imagery.
Can Ideogram 3.0 render exact wording?
Put the exact words in quotation marks and describe their position. Check every result for spelling errors, especially when the text is long or the scene is crowded.
Which languages work best?
English gives the most reliable results, especially for lettering. Accented letters and non-Latin scripts can render incorrectly or disappear.
How long should an Ideogram 3.0 prompt be?
Aim for fewer than about 150 words. Put the main subject and essential wording first, then describe placement, lighting, and style.
When should I turn off Magic Prompt?
Turn it off when your brief already specifies the wording and visual details you want. Leave it on when you want a short idea expanded with additional detail.
Start using Ideogram 3.0 Edit in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


