How to Use Seedream 5.5 Image Edit in Codex
Seedream 5.5 Image Edit refines existing artwork with targeted changes while preserving untouched areas. Unlike Seedream 5.5 Text to Image, it uses reference images to guide the result.
Prompts to try with Seedream 5.5 Image Edit in Codex
Copy an example into Codex, or ask in your own words.
Use Seedream 5.5 Image Edit on the product photo in public/images to replace the tabletop with dark oak. Preserve the product shape, label, camera angle, and framing; output a 2048 × 2048 image.
Use Seedream 5.5 Image Edit on the existing character artwork to change only the coat from brown to forest green. Preserve the face, pose, linework, and accessories; return a 1536 × 1536 transparent PNG.
Remove the background from the photo I attach with Seedream 5.5 Image Edit and give me a transparent PNG. Save the result in ./assets.
Use Seedream 5.5 Image Edit to clean up these product shots so they sit on pure white.
Edit this image with Seedream 5.5 Image Edit: keep the subject, swap the background for a sunlit studio.
How to set up Seedream 5.5 Image Edit in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex 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 Seedream 5.5 Image Edit
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": "bytedance/seedream/v5.5/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.5 Image Edit on Spiral, shows the price and runs it.
Seedream 5.5 Image Edit providers and prices
Spiral runs Seedream 5.5 Image Edit through fal. Open a card for today's price, with every fee included.
$0.06825 per run at the default inputs. $0.06825 per unit of num_images. Each item in image_urls adds $0.0156.
Settings you can ask for
Seedream 5.5 Image Edit works from your prompt and image URLs. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of images | 1 to 6 | 1 | Number of separate model generations to run with the prompt. |
| Output format | jpeg or png | png | The file format of the generated image. |
| Watermark | on or off | off | Whether to add the provider's visible watermark. |
| Background | auto, opaque, or transparent | auto |
|
Every API field of Seedream 5.5 Image Edit is on its tool page: open its card above.
What can you do with Seedream 5.5 Image Edit in Codex?
Create project artwork, character assets, and illustrated content while working on the code that uses them. Give Seedream 5.5 a concrete visual brief and dimensions that match the intended placement.
Transparent sticker artwork
Create a sticker concept from a written description, or refine supplied sticker artwork. Ask for a transparent PNG so the design can sit over different backgrounds.
Game character assets
Develop character artwork from a brief or an existing character reference. Request an isolated pose with a transparent background for use in a game layout.
Editorial photography concepts
Explore a portrait or still-life idea from text, or adjust a supplied image. Specify the light direction, visible materials, camera angle, and intended mood.
Posters with readable copy
Draft a poster from a written brief or revise existing poster artwork. Supply the exact English or Chinese wording, describe its placement, and check the finished lettering.
Product scene concepts
Use text to explore a proposed product scene, including glass, fabric, or metal surfaces. Use a product reference when the task starts from an existing product image.
Interior design studies
Sketch a room concept from a description, or revise furnishings in a supplied room image. Name the materials, lighting, and furniture placement to explore.
Controlled campaign revisions
Revise supplied campaign artwork one change at a time, such as replacing a prop or changing a jacket color. Identify the face, layout, lettering, and lighting that should stay unchanged.
Illustrated information layouts
Draft an illustrated information sheet from text, or refine an existing layout. Provide approved captions and review every label before sharing the result.
More on Seedream 5.5 Image Edit and Codex
Overview
Seedream 5.5 Image Edit in other agents
Questions about Seedream 5.5 Image Edit in Codex
Can Codex use Seedream 5.5 Image Edit?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Seedream 5.5 Image Edit like any built-in tool.
How much does Seedream 5.5 Image Edit cost in Codex?
$0.06825 per run at the default inputs. $0.06825 per unit of `num_images`. Each item in `image_urls` adds $0.0156. 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.5 Image Edit in Codex?
No. Spiral runs Seedream 5.5 Image 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 5.5 Image Edit in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Seedream 5.5 Image Edit runs?
Seedream 5.5 Image Edit runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.
What is Seedream 5.5 good at?
Seedream 5.5 is useful for photographic scenes where lighting, materials, and skin texture matter. Its documented Chinese and English text rendering also makes posters and illustrated information layouts worth trying.
How large can Seedream 5.5 images be?
Images must contain 921,600 to 4,624,220 pixels, with a width-to-height ratio between 1:16 and 16:1. A 2048 × 2048 square fits; a 4096 × 4096 square exceeds the limit.
Can Seedream 5.5 create transparent assets?
Yes. Seedream 5.5 supports full and partial transparency, which is useful for stickers, character art, and elements placed over other artwork. Request PNG output to retain transparency.
Can Seedream 5.5 render Chinese and English text?
ByteDance documents text-rendering evaluations in both languages, including densely arranged small text. For a poster or infographic, provide the exact wording and review the rendered copy before using it.
Why does Seedream 5.5 sometimes miss details in a brief?
BytePlus warns that very long prompts can scatter information and cause missing elements. Keep English prompts under its recommended 600 words and put the essential subject, composition, and constraints first.
Start using Seedream 5.5 Image Edit in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


