How to Use Recraft 20B in Gemini CLI
Recraft 20B, also called Recraft V2, makes icons, textured illustrations, and vector artwork with brand color control. Compared with Recraft V3, it is less reliable at following detailed prompts and rendering text.
Prompts to try with Recraft 20B in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
Use Recraft 20B to create a square vector illustration of an open folder for the project's empty document screen. Read the design tokens for preferred colors, use a flat style, and keep lettering out of the artwork.
Read the onboarding copy and use Recraft 20B to generate one illustration per step. Use the same digital illustration style, palette, and centered framing throughout; keep instructions as interface text.
Use Recraft 20B to create a 1024 × 1024 photographic concept for the recipe project's homepage: a bowl of tomato soup on a wooden table, viewed from above, with soft window light.
Inspect the project's navigation and use Recraft 20B to explore simple vector icons for search, bookmarks, and delivery. Request each separately with the same line art style and preferred colors, then show them together for review.
Use Recraft 20B to make a grain-textured illustration for the project's article about calendar overload: a crowded paper calendar beside a single clear day. Keep the brief under 1,000 characters and add the title through the page layout.
How to set up Recraft 20B 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 Recraft 20B
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/recraft-20b", "input": { "prompt": "a red panda in Kyoto" } }'
Then paste one of the prompts above: Gemini CLI finds Recraft 20B on Spiral, shows the price and runs it.
Recraft 20B providers and prices
Spiral runs Recraft 20B through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Recraft 20B works from your prompt. Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Style | any, realistic_image, digital_illustration, vector_illustration, realistic_image/b_and_w, realistic_image/enterprise, realistic_image/hard_flash, realistic_image/hdr and 29 more | realistic_image | The style of the generated images. Vector images cost 2X as much. |
Every API field of Recraft 20b is on its tool page: open its card above.
What can you do with Recraft 20B in Gemini CLI?
Turn interface requirements into icons and illustrations that fit the project. Use the project's design tokens and screen content to write focused briefs, then review the generated assets in context.
App icon concepts
Create simple symbols for search, saved items, delivery, or account screens. Keep the visual brief consistent and review the icons together before using them.
Onboarding illustrations
Illustrate actions such as organizing tasks or saving a document with a shared style and palette. Add instructional text in the interface.
Editorial artwork
Turn an article's central idea into a textured illustration, such as a tangled calendar for an essay about overcommitment.
Presentation graphics
Generate coordinated illustrations for topics such as planning, collaboration, and delivery. Keep slide titles and data labels separate from the artwork.
Brand symbol exploration
Explore simple vector symbols for a business, publication, or event. Develop the lettering separately when the name must be exact.
Social post artwork
Create a series of illustrations around one campaign theme using a shared visual treatment. Leave space for captions added during layout.
Photographic concepts
Explore photographic scenes for an article or creative brief, such as a ceramic cup beside a window. Describe the light, materials, and viewing angle.
More on Recraft 20B and Gemini CLI
Overview
Recraft 20B in other agents
Questions about Recraft 20B in Gemini CLI
Can Gemini CLI use Recraft 20B?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Recraft 20B like any built-in tool.
How much does Recraft 20B cost in Gemini CLI?
$0.02847 per image. 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 Recraft 20B in Gemini CLI?
No. Spiral runs Recraft 20B on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Recraft 20B in Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while Recraft 20B runs?
Recraft 20B runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.
What is Recraft 20B best for?
Start with minimalistic icons, textured illustrations, and vector artwork. It also suits coordinated graphics that share a visual style and brand palette.
Is Recraft 20B the same as Recraft V2?
Yes. Recraft documents V2 as its 20-billion-parameter image model.
Can Recraft 20B render accurate text?
Text accuracy is a documented weakness, and Recraft V3 handles it better. For a graphic that needs exact wording, generate the artwork first and add the lettering separately.
How should I write a Recraft 20B prompt?
Start with the subject, then describe its position, viewing angle, and surroundings. Keep the brief focused and within Recraft's documented 1,000-character V2 limit.
How do I get closer to my brand colors?
Use a simple subject and a restrained style when palette matching matters. Recraft warns that complex prompts and styles make limited palettes harder to follow, so inspect the result before using it.
Start using Recraft 20B 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


