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

falImageAvailable nowReleased 2026-11-11

Seedream 5.5 Image Edit

bytedance/seedream/v5.5/edit

Edit and enhance images with Seedream 5.5 Image Edit from fal through one Spiral API key. Seedream 5.5 edits images from text instructions and up to 10 reference images, with configurable output dimensions and support for transparent PNG backgrounds. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

$0.06825 per run at the default inputs. $0.06825 per unit of num_images. Each item in image_urls adds $0.0156.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

The text prompt used to edit the image.

image_sizeJSONauto_2K

The size of the generated image. Total pixels must be between 921600 and 4624220, with aspect ratio between 1/16 and 16.

num_imagesnumber (whole)
1 to 6
1

Number of separate model generations to run with the prompt.

output_formatone of
jpeg, png
png

The file format of the generated image.

watermarktrue or falsefalse

Whether to add the provider's visible watermark.

backgroundone of
auto, opaque, transparent
auto

auto lets the model choose from the prompt and output format. transparent returns an RGBA image and requires output_format=png.

image_urls requiredURLs or files—

List of URLs of input reference images. Up to 10 images are supported; if more are sent, only the last 10 are used.

Same request in code

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>"
      ]
    }
  }'

Frequently asked questions

How much does Seedream 5.5 Image Edit cost?

$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 as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Seedream 5.5 Image Edit through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bytedance/seedream/v5.5/edit"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Seedream 5.5 Image Edit?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Seedream 5.5 Image Edit?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.