Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Image

How to Use Bria Fast in Gemini CLI

Bria Fast suits quick visual exploration for campaign concepts, illustrations, and website imagery. Choose it over Bria HD when you want to explore directions quickly; choose HD when native image detail matters more.

Prompts to try with Bria Fast in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Read the homepage copy and use Bria Fast to generate a 16:9 photograph of a small woodworking studio in morning window light. Put the workbench on the right and leave the left third uncluttered for the heading.

Bria FastGemini CLI
Try asking
  • Use Bria Fast to create a square illustration for the garden planning screen: raised vegetable beds viewed from above, muted green and brown colors, clear paths, no lettering. Match the palette in the project's styles.

  • Use Bria Fast to generate a 16:9 landscape concept for the game's harbor level: low viewpoint, wooden docks in the foreground, stone warehouses behind, overcast morning. Save the seed and exact prompt beside the asset.

  • Generate a product photo with Bria Fast: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.

  • Make four logo concepts for a coffee brand called "Northline" with Bria Fast.

How to set up Bria Fast in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. Run Bria Fast

    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/bria/text-to-image/fast",
        "input": {
          "prompt": "A lone figure stands on the edge of a serene cliff at sunset, gazing out over a vast, mystical valley. The figure is clad in flowing robes that ripple in the…"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Bria Fast on Spiral, shows the price and runs it.

Bria Fast providers and prices

Spiral runs Bria Fast through fal. Open a card for today's price, with every fee included.

falImage
Bria Fast · Text to Image
fal-ai/bria/text-to-image/fast

Settings you can ask for

Bria Fast works from your prompt. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Negative promptwhat to leave out, in words

The negative prompt you would like to use to generate images.

Number of images1 to 44

How many images you would like to generate. When using any Guidance Method, Value is set to 1.

Aspect ratio1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16 and 1 more1:1

The aspect ratio of the image. When a guidance method is being used, the aspect ratio is defined by the guidance image and this parameter is ignored.

Seed0 to 2147483647

The same seed and the same prompt given to the same version of the model

will output the same image every time.

Number of inference steps4 to 108

The number of iterations the model goes through to refine the generated image. This parameter is optional.

Guidance scale (CFG)0 to 205

The CFG (Classifier Free Guidance) scale is a measure of how close you want

the model to stick to your prompt when looking for a related image to show you.

Prompt enhancementon or offoff

When set to true, enhances the provided prompt by generating additional, more descriptive variations, resulting in more diverse and creative output images.

Mediumphotography or art

Which medium should be included in your generated images. Omit or set to null to let Bria select the medium.

Every API field of Bria Fast · Text to Image is on its tool page: open its card above.

What can you do with Bria Fast in Gemini CLI?

Bria lets a coding agent create website imagery and visual concepts from a project's written brief. Ask the agent to match the intended layout and keep generated artwork separate from page typography.

Website hero imagery

Generate a scene with the subject on one side and open space for a headline. Specify the light direction and background materials before adding the image to a page.

Campaign concept exploration

Explore different settings for the same campaign brief, such as a kitchen, garden, or studio. Compare the visual directions before choosing an image for closer review.

Social post artwork

Create square still lifes or portrait scenes around a seasonal theme. Leave space for captions and add the final copy separately.

Product concept scenes

Visualize an imagined product in a specific setting, such as a ceramic soap dispenser on a stone sink. Use these images to review presentation ideas before photographing the actual item.

Game environment concepts

Turn a written location brief into a landscape or interior concept. Specify viewpoint, weather, materials, and lighting so the image communicates a clear art direction.

Composition studies from references

Use an existing image's edges or depth to guide a new scene. Explore different materials and lighting while using the reference to direct the layout.

Questions about Bria Fast in Gemini CLI

Can Gemini CLI use Bria Fast?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Bria Fast like any built-in tool.

How much does Bria Fast cost in Gemini CLI?

$0.0364 per generation. Billed on `num_images`, default 4. 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 Bria Fast in Gemini CLI?

No. Spiral runs Bria Fast on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Bria Fast in Gemini CLI?

About two minutes: add the server, then sign in, then check it.

Does Gemini CLI wait while Bria Fast runs?

Bria Fast runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

When should I choose Bria Fast or Bria HD?

Choose Bria Fast to explore visual directions quickly. Choose Bria HD when native detail is the priority, such as inspecting surfaces, lighting, and scene texture.

How should I write a Bria prompt?

Describe the subject, setting, framing, light direction, and visible materials. A description such as matte ceramic beside a window gives clearer direction than a stack of words such as masterpiece or stunning.

Which language should I use for Bria prompts?

Write prompts in English and avoid special characters. Translate a non-English brief into a concrete English scene description before generating.

Can Bria reproduce an image I generated earlier?

Yes, the documentation states that the same prompt and seed on the same model version produce the same image. Save the exact prompt and seed with an image you want to reproduce.

Can a reference image guide Bria's composition?

Yes. Use edge guidance for structural outlines or depth guidance for spatial arrangement; when combining guidance images, make sure their aspect ratios match.

Get started

Start using Bria Fast 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 Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options