# Bytedance Seedream V4 Edit · Seedream 4.0 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.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image
- Tool id: `fal` / `fal-ai/bytedance/seedream/v4/edit`
- Page: https://spiral.ai/tools/fal/fal-ai/bytedance/seedream/v4/edit

## Pricing

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

## Limits

- 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

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | The text prompt used to edit the image |
| `image_size` | JSON |  | {"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_images` | number (whole) | 1 to 6 | 1 | Number of separate model generations to be run with the prompt. |
| `max_images` | number (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 |
| `seed` | number (whole) |  | — | Random seed to control the stochasticity of image generation. |
| `enhance_prompt_mode` | one 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` (required) | URLs 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. |

## Example

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

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fbytedance%2Fseedream%2Fv4%2Fedit

## Common questions

### Bytedance Seedream V4 Edit · Seedream 4.0 Edit

**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.

