How to Use Ideogram Vector in Gemini CLI
Ideogram Vector creates editable SVG artwork for logos, lettering, stickers, and illustrations. It generates designs from a written brief, with optional image references to guide the result.
Prompts to try with Ideogram Vector in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Ideogram Vector to create an empty-state illustration for the reading list in this project: three books and a bookmark, flat shapes, no lettering. Read the theme colors and preview the SVG in the component.
Use Ideogram Vector to draft a square logo for the bakery described in README.md. Use one wheat stalk, the exact business name, and two colors from the stylesheet.
Use Ideogram Vector to create a wide illustration for the garden app's welcome screen: a watering can beside three seedlings, simple shapes, and open space on the left for interface text.
Use Ideogram Vector to make a bicycle repair emblem using assets/shop-sketch.png as the primary reference. Keep the wheel-and-wrench idea and simplify the composition for the contact page.
Use Ideogram Vector to create a square illustration for this project's donation confirmation page: two hands holding a small plant, dark green and white, no text. Add a preview for review.
How to set up Ideogram Vector in Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI 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 Vector
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": "ideogram/vector/text-to-vector", "input": { "prompt": "A playful cat logo with bold outlines and flat colors" } }'
Then paste one of the prompts above: Gemini CLI finds Ideogram Vector on Spiral, shows the price and runs it.
Ideogram Vector providers and prices
Spiral runs Ideogram Vector through fal. Open a card for today's price, with every fee included.
$0.208 per run at the default inputs. quality: low $0.169, medium (default) $0.208, high $0.26. Per unit of num_images: low $0.169, medium (default) $0.208, high $0.26.
Settings you can ask for
Ideogram Vector works from your prompt and image URLs. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Quality | low, medium, or high | medium | Generation quality. |
| Number of images | 1 to 8 | 1 | Number of SVGs to generate. |
| Aspect ratio | auto, 1:1, 1:4, 1:3, 1:2, 9:16, 10:16, 2:3 and 10 more | auto | The aspect ratio of the generated SVG. |
| Seed | 0 to 2147483647 | Seed for reproducible generation. |
Every API field of Ideogram Vector Text to SVG is on its tool page: open its card above.
What can you do with Ideogram Vector in Gemini CLI?
Create SVG artwork for the interface you are building. A coding agent can turn project context into a design brief and place the result in a page for review.
Logo concepts
Explore a bakery mark built around a wheat stalk and a short business name.
Event lettering
Create illustrated lettering for a community garden's spring plant sale.
Sticker designs
Draft a bicycle repair sticker with a wrench, wheel, and short slogan.
Merchandise artwork
Develop a two-color mountain illustration for a hiking club shirt.
Website illustrations
Create a small illustration of an empty bookshelf for a reading app.
Product labels
Design a botanical label concept for a jar of orange marmalade.
Reference-guided artwork
Use a supplied sketch to guide a new illustrated coffee cart emblem.
More on Ideogram Vector and Gemini CLI
Overview
Ideogram Vector in other agents
Questions about Ideogram Vector in Gemini CLI
Can Gemini CLI use Ideogram Vector?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Ideogram Vector like any built-in tool.
How much does Ideogram Vector cost in Gemini CLI?
$0.208 per run at the default inputs. `quality`: low $0.169, medium (default) $0.208, high $0.26. $0.208 per unit of `num_images`. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need a fal account to use Ideogram Vector in Gemini CLI?
No. Spiral runs Ideogram Vector 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 Vector in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Ideogram Vector runs?
Ideogram Vector runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.
What is Ideogram Vector useful for?
Use it for logos, illustrated lettering, stickers, print designs, and illustrations that need editable shapes.
Does Ideogram Vector return an actual SVG?
Yes. The output is editable SVG artwork, so you can refine the design after generation.
What resolution should I use for large artwork?
SVG shapes scale without losing sharpness. Choose the composition for its intended placement, then size the artwork for your layout.
Can I retype the words in the SVG?
Expect to edit or replace letter shapes. In Ideogram's inspected examples, lettering is outlined rather than stored as live text.
How should I write a prompt?
Describe the subject, placement, and visual style. Include the exact words the artwork should display.
Start using Ideogram Vector in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


