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

falImageAvailable nowReleased 2025-09-09

Bytedance Seedream V4 Edit · Seedream 4.0 Edit

fal-ai/bytedance/seedream/v4/edit

Edit and enhance images with Bytedance Seedream V4 Edit · Seedream 4.0 Edit from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

$0.039 per image. Billed on num_images, default 1.

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_sizeJSON{"width":2048,"height":2048}

The size of the generated image. The minimum total image area is 921600 pixels. Failing this, the image size will be adjusted to by scaling it up, while maintaining the aspect ratio.

num_imagesnumber (whole)
1 to 6
1

Number of separate model generations to be run with the prompt.

max_imagesnumber (whole)
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

seednumber (whole)—

Random seed to control the stochasticity of image generation.

enhance_prompt_modeone of
standard, fast
standard

The mode to use for enhancing prompt enhancement. Standard mode provides higher quality results but takes longer to generate. Fast mode provides average quality results but takes less time to generate.

image_urls requiredURLs or files—

List of URLs of input images for editing. Presently, up to 10 image inputs are allowed. If over 10 images are sent, only the last 10 will be 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": "fal-ai/bytedance/seedream/v4/edit",
    "input": {
      "prompt": "Dress the model in the clothes and hat. Add a cat to the scene and change the background to a Victorian era building.",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'

Frequently asked questions

How much does Bytedance Seedream V4 Edit · Seedream 4.0 Edit cost?

$0.039 per image. Billed on `num_images`, default 1. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Bytedance Seedream V4 Edit · Seedream 4.0 Edit through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/bytedance/seedream/v4/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 Bytedance Seedream V4 Edit · Seedream 4.0 Edit?

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

Can my AI agent use Bytedance Seedream V4 Edit · Seedream 4.0 Edit?

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