How to Use Boogu Image in Gemini
Boogu Image creates posters, document layouts, photos, and illustrations from text, with support for Chinese and English lettering. Use detailed descriptions, and proofread dense text for missing characters or layout errors.
Prompts to try with Boogu Image in Gemini
Copy an example into Gemini, or ask in your own words.
Use Boogu Image to make a square poster for a neighborhood book swap. Put 'Bring a book' at the top, show a stack of worn books below, and use a two-color screen-print style.
Use Boogu Image to create a wide editorial photo of a quiet repair workshop. Show one wooden bench, neatly arranged tools, and afternoon window light. Keep the scene free of lettering.
Use Boogu Image to make a portrait poster with '春日书会' above 'Spring reading club.' Place a small ink painting of a flowering branch below the text, with generous white space.
Use Boogu Image to create a square illustrated cover showing a tiny observatory on a snowy hill. Use watercolor, muted blue and rust colors, and a clear night sky. Include no text.
Use Boogu Image to make a portrait title-page concept for 'A field guide to urban gardens.' Show the title in large lettering above a botanical illustration, with a simple layout and no small print.
How to set up Boogu Image in Gemini
Pick the way that suits you. Each takes about two minutes.
Use the Gemini connector
- Open Connected Apps
On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.
- Add Spiral as a custom app
Under Custom apps, click Add a custom app and paste this MCP server URL:
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.
Use the Spiral skill
- Send Gemini 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 Boogu Image
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/boogu-image", "input": { "prompt": "A street photography shot of an elderly scavenger with a deeply weathered face in the center of the frame, a trash can and a traffic light in the background.…" } }'
Then paste one of the prompts above: Gemini finds Boogu Image on Spiral, shows the price and runs it.
Boogu Image providers and prices
Spiral runs Boogu Image through fal. Open a card for today's price, with every fee included.
$0.052 per megapixel. image_size presets count as 1 MP; custom sizes round up to whole megapixels. Billed on num_images, default 1.
Settings you can ask for
Boogu Image works from your prompt. Ask Gemini for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Negative prompt | what to leave out, in words | Describes what should NOT appear in the image. Used for classifier-free guidance; leave empty to disable text negative guidance. | |
| Number of inference steps | 20 to 50 | 30 | The number of denoising steps to perform. |
| Guidance scale | 1 to 8 | 4 | Controls how closely generation follows the text instruction. Higher values stick more closely to the prompt. A value of 1.0 disables text classifier-free guidance. |
| CFG range start | 0 to 1 | 0 | Start of the timestep fraction over which CFG is applied. |
| CFG range end | 0 to 1 | 1 | End of the timestep fraction over which CFG is applied. |
| Number of images | 1 to 4 | 1 | The number of images to generate. |
| Seed | a whole number | The same seed and the same prompt given to the same version of the model will output the same image every time. | |
| Output format | jpeg or png | jpeg | The format of the generated image. |
Every API field of Boogu Image · Text to Image is on its tool page: open its card above.
What can you do with Boogu Image in Gemini?
Make a visual draft from an idea you describe in conversation with Boogu Image. A chat app can help specify the scene, medium, and lettering before generating a poster, photo, or illustration.
Event poster concepts
Draft a poster from an event description, with a clear headline and a small amount of supporting copy. Check every date and letter before using it.
Chinese and English campaign artwork
Explore artwork containing supplied Chinese and English headlines. Specify the placement and relative size of each language.
Document layout studies
Test the visual hierarchy of a title page or short information sheet before rebuilding the chosen layout in a document editor.
Brand guide concepts
Explore a brand guide page using a written palette, typography direction, and short sample headings.
Editorial photo concepts
Turn a written article brief into a photographic scene with specified framing, lighting, and background details.
Illustrated covers
Explore a cover in a chosen artistic medium, with a defined focal subject and space for the title.
More on Boogu Image and Gemini
Overview
Boogu Image in other agents
Questions about Boogu Image in Gemini
Can Gemini use Boogu Image?
Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Boogu Image like any built-in tool.
How much does Boogu Image cost in Gemini?
$0.052 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. 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 Gemini plan is separate.
Do I need a fal account to use Boogu Image in Gemini?
No. Spiral runs Boogu Image on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Boogu Image in Gemini?
About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.
Does Gemini wait while Boogu Image runs?
Boogu Image runs in the background. Gemini starts the run, checks on it and gives you the image when it's ready.
What is Boogu Image useful for?
Try posters, document concepts, bilingual lettering, editorial photos, and illustrated covers. Describe the intended layout as carefully as the subject.
Can Boogu Image write Chinese and English in an image?
Yes. It supports Chinese and English text rendering, though generated lettering still needs proofreading before use.
How large can Boogu Image generate?
Its maximum native resolution is 2K. Asking for a larger image is clamped to that limit.
Why does Boogu Image sometimes misspell text?
Long passages, small fonts, dense typography, and complex layouts remain documented weaknesses. Shorten the copy and simplify the layout when letters go missing or text shifts.
How should I prompt Boogu Image?
Use a detailed description of the subject, composition, lighting, colors, and intended lettering. For example, specify where a headline belongs and provide its exact wording.
Start using Boogu Image in Gemini
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini:
set up https://spiral.ai/SKILL.md


