[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Seedream 5.0 Pro Image Editing](https://spiral.ai/integrations/codex/seedream-5-0-pro-image-editing)

# How to Use Seedream 5.0 Pro Image Editing in Codex

Use Seedream 5.0 Pro Image Editing for quality-focused revisions guided by references, sketches, or marked regions. Compared with Seedream 5.0 Flash Image Editing, it prioritizes image quality over speed.

|  |  |
| --- | --- |
| Model | Seedream 5.0 Pro Image Editing |
| Available through | fal |
| Category | Image |
| Price | Up to $0.1755 per run at the default inputs. $0.1755 per unit of `num_images`. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Seedream 5.0 Pro Image Editing in Codex

- Use Seedream 5.0 Pro Image Editing to revise assets/poster.png with the approved translation in locales/es.json. Replace the headline and supporting copy, then identify lettering that needs review.
- Use Seedream 5.0 Pro Image Editing to follow the marked regions in assets/layout-review.png. Replace the marked product with assets/product.png and remove the review marks from the resulting artwork.
- Use Seedream 5.0 Pro Image Editing to combine assets/scene.png, assets/product.png, and assets/logo.png. Take the composition from the first image, the product from the second, and the logo from the third.
- Remove the background from the photo I attach with Seedream 5.0 Pro Image Editing and give me a transparent PNG. Save the result in ./assets.
- Use Seedream 5.0 Pro Image Editing to clean up these product shots so they sit on pure white.

## How to set up Seedream 5.0 Pro Image Editing in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 5.0 Pro Image Editing**: 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": "bytedance/seedream/v5/pro/edit",
    "input": {
      "prompt": "Replace the product in Figure 1 with that in Figure 2. Seamlessly render the logo in Figure 3 into the product design, in a frosted glass texture.",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: Codex finds Seedream 5.0 Pro Image Editing on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Seedream 5.0 Pro Image Editing tools and prices

- [Seedream 5.0 Pro Image Editing](https://spiral.ai/tools/fal/bytedance/seedream/v5/pro/edit) (fal): Up to $0.1755 per run at the default inputs. $0.1755 per unit of `num_images`.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | auto_2K | The size of the generated image. Total pixels must be between 921600 and 4624220, with aspect ratio between 1/16 and 16. |
| num_images | 1 to 6 | 1 | Number of separate model generations to run with the prompt. |
| output_format | jpeg, png | jpeg | The file format of the generated image. |
| watermark |  | false | Whether to add the provider's visible watermark. |
| image_passthrough |  | false | Preserve original reference and output image bytes, formats, and dimensions without resizing or re-encoding. |
| background | opaque, transparent | opaque | Use `transparent` with exactly one alpha-channel reference and PNG output to preserve transparency. |

## What can you do with Seedream 5.0 Pro Image Editing in Codex?

Turn project briefs and product copy into image concepts without leaving your development work. Use Seedream 5.0 to explore artwork and structured visual designs alongside implementation.

### Product image revisions

Start with a product image and request a specific replacement or visual change, using a second reference when needed.

### Poster localization

Start with existing artwork and replace its text with approved translated copy. Inspect lettering and surrounding design details afterward.

### Sketch-guided revisions

Mark an existing image to show where an object belongs, then describe the replacement or addition in plain language.

### Reference-based compositions

Combine a supplied scene, product reference, and logo reference into one composition, stating what each image contributes.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Seedream 5.0 Pro Image Editing in other agents

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

## More Codex guides

- [Seedream 5.0 Lite Text to Image](https://spiral.ai/integrations/codex/seedream-5-0-lite-text-to-image)
- [Seedream 5.0 Pro Layerize](https://spiral.ai/integrations/codex/seedream-5-0-pro-layerize)
- [Seedream 5.0 Lite Image Editing](https://spiral.ai/integrations/codex/seedream-5-0-lite-image-editing)
- [Seedream 5.0 Pro Text to Image](https://spiral.ai/integrations/codex/seedream-5-0-pro-text-to-image)
- [Seedream 5.0 Flash Text to Image](https://spiral.ai/integrations/codex/seedream-5-0-flash-text-to-image)
- [Seedream 5.5 Image Edit](https://spiral.ai/integrations/codex/seedream-5-5-image-edit)

## Questions about Seedream 5.0 Pro Image Editing in Codex

**Can Codex use Seedream 5.0 Pro Image Editing?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Seedream 5.0 Pro Image Editing like any built-in tool.

**How much does Seedream 5.0 Pro Image Editing cost in Codex?**

Up to $0.1755 per run at the default inputs. $0.1755 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 Codex plan is separate.

**Do I need a fal account to use Seedream 5.0 Pro Image Editing in Codex?**

No. Spiral runs Seedream 5.0 Pro Image Editing 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 5.0 Pro Image Editing in Codex?**

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

**Does Codex wait while Seedream 5.0 Pro Image Editing runs?**

Seedream 5.0 Pro Image Editing runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.

**What is Seedream 5.0 useful for?**

Use it for visual concepts, text-rich graphics, and multilingual designs. Pro is especially suited to work where layout and image quality matter.

**How do Seedream 5.0 Flash and Pro differ?**

Flash favors faster generation and iteration. Pro prioritizes image quality, making it a useful choice for more demanding design work.

**Can Seedream 5.0 handle multilingual artwork?**

Yes. Pro and Flash support native multilingual generation, so localized posters and other graphics are practical uses.

**Can Seedream 5.0 create infographics?**

Yes. Use a clear information hierarchy and supply the content you want included; Pro is designed for dense layouts and structured designs.

**What should I inspect before using an image?**

Check small lettering and fine visual details before publishing. ByteDance acknowledges room for improvement in Pro's fine text rendering and editing consistency.

