[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Seedream 4.5 Edit](https://spiral.ai/integrations/gemini-cli/seedream-4-5-edit)

# How to Use Seedream 4.5 Edit in Gemini CLI

Seedream 4.5 Edit revises images while preserving details such as faces, lighting, and color. Unlike Seedream 4.5 Text to Image, it uses reference images for tasks such as product swaps, background changes, and layout edits.

|  |  |
| --- | --- |
| Model | Seedream 4.5 Edit |
| Available through | fal |
| Category | Image |
| Price | $0.052 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Seedream 4.5 Edit in Gemini CLI

- Use Seedream 4.5 Edit with the product photo in this project's assets folder. Replace the background with a pale blue studio backdrop while preserving the product's shape, label, color, and camera angle. Produce one 2K square image.
- Use Seedream 4.5 Edit with the project's existing campaign image and replacement product photo. Replace only the product, preserve the headline and layout, and match the existing lighting. Produce one 2K square image.
- Remove the background from the photo I attach with Seedream 4.5 Edit and give me a transparent PNG. Save the result in ./assets.
- Use Seedream 4.5 Edit to clean up these product shots so they sit on pure white.
- Edit this image with Seedream 4.5 Edit: keep the subject, swap the background for a sunlit studio.

## How to set up Seedream 4.5 Edit 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:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Seedream 4.5 Edit**: One request; the result comes back by polling or a webhook.

```bash
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/bytedance/seedream/v4.5/edit",
    "input": {
      "prompt": "Replace the product in Figure 1 with that in Figure 2. For the title copy the text in Figure 3 to the top of the screen, the title should have a clear contrast…",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Seedream 4.5 Edit tools and prices

- [Bytedance Seedream V4.5 Edit · Image Editing](https://spiral.ai/tools/fal/fal-ai/bytedance/seedream/v4.5/edit) (fal): $0.052 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | {"width":2048,"height":2048} | The size of the generated image. Width and height must be between 1920 and 4096, or total number of pixels must be between 2560*1440 and 4096*4096. |
| num_images | 1 to 6 | 1 | Number of separate model generations to be run with the prompt. |
| max_images | 1 to 6 | 1 | If set to a number greater than one, enables multi-image generation. The model will potentially return up to `max_images` images every generation, and in total, `num_images` generations will be carried out. In total, the number of images generated will be between `num_images` and `max_images*num_images`. The total number of images (image inputs + image outputs) must not exceed 15 |
| seed |  | — | Random seed to control the stochasticity of image generation. |

## What can you do with Seedream 4.5 Edit in Gemini CLI?

Create visual assets from the project's design brief, including posters, product concepts, and promotional artwork. Your coding agent can turn layout requirements into focused Seedream 4.5 prompts and review the results against the brief.

### Event poster concepts

Develop a poster with a clear title, supporting details, and a specified visual hierarchy. Use a written brief for new artwork or reference artwork for an edit.

### Packaging design studies

Explore package imagery, material appearance, and label placement before choosing a design direction. Check every word in the result.

### Campaign artwork

Develop promotional images around a specific subject, palette, lighting treatment, and headline. Describe each composition separately so its priorities stay clear.

### Product presentation concepts

Explore how a product could appear in a studio or lifestyle scene. Start from a description for concept work, or use Seedream 4.5 Edit with the actual product image.

### Film and game concept art

Develop characters, environments, and scene compositions for pre-production. Specify materials, lighting, and the relationship between objects.

### Product swaps in existing artwork

Replace a product in an existing composition using a separate product reference. State which layout, lighting, and lettering should stay unchanged.

### Portrait background and wardrobe edits

Change the setting or clothing in a portrait while asking to preserve the person's facial features. Identify the source of each replacement when using multiple references.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Seedream 4.5 Edit in other agents

- [Amp](https://spiral.ai/integrations/amp/seedream-4-5-edit)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/seedream-4-5-edit)
- [Claude](https://spiral.ai/integrations/claude-desktop/seedream-4-5-edit)
- [Claude Code](https://spiral.ai/integrations/claude-code/seedream-4-5-edit)
- [Cline](https://spiral.ai/integrations/cline/seedream-4-5-edit)
- [Codex](https://spiral.ai/integrations/codex/seedream-4-5-edit)
- [Cursor](https://spiral.ai/integrations/cursor/seedream-4-5-edit)
- [Devin](https://spiral.ai/integrations/devin/seedream-4-5-edit)
- [dots](https://spiral.ai/integrations/dots/seedream-4-5-edit)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/seedream-4-5-edit)
- [Gemini](https://spiral.ai/integrations/gemini/seedream-4-5-edit)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/seedream-4-5-edit)
- [goose](https://spiral.ai/integrations/goose/seedream-4-5-edit)
- [Grok](https://spiral.ai/integrations/grok/seedream-4-5-edit)
- [Grok Build](https://spiral.ai/integrations/grok-build/seedream-4-5-edit)
- [Hermes](https://spiral.ai/integrations/hermes/seedream-4-5-edit)
- [Instinct](https://spiral.ai/integrations/instinct/seedream-4-5-edit)
- [Manus](https://spiral.ai/integrations/manus/seedream-4-5-edit)
- [Muse](https://spiral.ai/integrations/muse/seedream-4-5-edit)
- [Muse Code](https://spiral.ai/integrations/muse-code/seedream-4-5-edit)
- [n8n](https://spiral.ai/integrations/n8n/seedream-4-5-edit)
- [Notion](https://spiral.ai/integrations/notion/seedream-4-5-edit)
- [OpenClaw](https://spiral.ai/integrations/openclaw/seedream-4-5-edit)
- [opencode](https://spiral.ai/integrations/opencode/seedream-4-5-edit)
- [Perplexity](https://spiral.ai/integrations/perplexity/seedream-4-5-edit)
- [Raycast](https://spiral.ai/integrations/raycast/seedream-4-5-edit)
- [VS Code](https://spiral.ai/integrations/vscode/seedream-4-5-edit)
- [Windsurf](https://spiral.ai/integrations/windsurf/seedream-4-5-edit)
- [Zapier](https://spiral.ai/integrations/zapier/seedream-4-5-edit)

## More Gemini CLI guides

- [Seedream 4.0 Text to Image](https://spiral.ai/integrations/gemini-cli/seedream-4-0-text-to-image)
- [Seedream 4.5 Text to Image](https://spiral.ai/integrations/gemini-cli/seedream-4-5-text-to-image)
- [Seedream 4.0 Edit](https://spiral.ai/integrations/gemini-cli/seedream-4-0-edit)
- [Seedream 5.0 Flash Image Editing](https://spiral.ai/integrations/gemini-cli/seedream-5-0-flash-image-editing)
- [Sana Sprint](https://spiral.ai/integrations/gemini-cli/sana-sprint)
- [Seedream 5.0 Flash Layerize](https://spiral.ai/integrations/gemini-cli/seedream-5-0-flash-layerize)

## Questions about Seedream 4.5 Edit in Gemini CLI

**Can Gemini CLI use Seedream 4.5 Edit?**

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

**How much does Seedream 4.5 Edit cost in Gemini CLI?**

$0.052 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 Gemini CLI plan is separate.

**Do I need a fal account to use Seedream 4.5 Edit in Gemini CLI?**

No. Spiral runs Seedream 4.5 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 Seedream 4.5 Edit in Gemini CLI?**

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

**Does Gemini CLI wait while Seedream 4.5 Edit runs?**

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

**What is Seedream 4.5 useful for?**

Seedream 4.5 suits visual work that combines an image with deliberate layout and lettering, such as posters, packaging concepts, and campaign artwork. Its documented strengths include composition, typography, and readable small text.

**What resolution can Seedream 4.5 produce?**

Seedream 4.5 supports 2K and 4K output. Choose the image shape to match its intended use, then describe where the subject and lettering should sit.

**Can Seedream 4.5 put words inside an image?**

Yes. Typography and readable small text are documented strengths, and the maker recommends enclosing the exact wording in double quotation marks. Check the finished lettering before using the image.

**Which prompt languages does Seedream 4.5 support?**

The maker documents Chinese and English prompt support. That does not establish equal accuracy for lettering in every language.

**How should I structure a Seedream 4.5 prompt?**

Write a clear description of the subject, action, and environment. Add the intended image type, composition, lighting, and exact lettering where they matter.

