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

falImageAvailable nowReleased 2026-07-08

Seedream 5.0 Pro Image Editing

bytedance/seedream/v5/pro/edit

Edit and enhance images with Seedream 5.0 Pro Image Editing from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

Up to $0.1755 per run at the default inputs. $0.1755 per unit of num_images.

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
jpeg

The file format of the generated image.

watermarktrue or falsefalse

Whether to add the provider's visible watermark.

image_passthroughtrue or falsefalse

Preserve original reference and output image bytes, formats, and dimensions without resizing or re-encoding.

backgroundone of
opaque, transparent
opaque

Use transparent with exactly one alpha-channel reference and PNG output to preserve transparency.

enhance_prompt_modeone of
standard, fast
standard

Prompt optimization mode. standard prioritizes image quality; fast reduces generation time.

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

Frequently asked questions

How much does Seedream 5.0 Pro Image Editing cost?

Up to $0.1755 per run at the default inputs. $0.1755 per unit of `num_images`. 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.0 Pro Image Editing through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bytedance/seedream/v5/pro/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.0 Pro Image Editing?

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

Can my AI agent use Seedream 5.0 Pro Image Editing?

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