# Krea 3 Edit · Image Editing

Edit and enhance images with Krea 3 Edit · Image Editing 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` / `krea/v3/edit`
- Page: https://spiral.ai/tools/fal/krea/v3/edit

## Pricing

Up to $0.26195 per run at the default inputs. Each item in `image_urls` adds $0.130975.

## 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 |  | — | Description of the image to generate. |
| `image_urls` (required) | URLs or files |  | — | Reference images to edit or combine (1-8). Order sets the <image-N> tags. |
| `model` | one of | berry, jam | berry | Model variant: berry favors quality, jam favors speed. |
| `image_size` | JSON |  | auto | Output size, rounded up to multiples of 16, at most 4,220,160 total pixels (1680×2512). auto lets the prompt expander pick the aspect ratio at about 2048×2048. |
| `reasoning_level` | one of | low, medium, high, ultra | medium | How much effort the harness spends reasoning about the given editing task. Higher reasoning effort means slower generation time. high plans the edit with segmentation, web search and reference photos, keeps unedited areas of a single input image, corrects required text, and bills a flat $0.125 (5 megapixels) more per request. low and medium bill $0.025 per megapixel of the output plus each reference (references larger than the output count as the output size). ultra generates at 2K with Krea's ultra thinking mode, ignores image_size and negative_prompt, and bills a flat price by reference count: $0.27 for 1, $0.30 for 2, $0.32 for 3, $0.35 for 4, plus $0.0275 per reference past 4. |
| `negative_prompt` | text |  |  | What to keep out of the image. Used by berry only. |
| `seed` | number (whole) |  | — | Latent noise seed. Use a new seed when editing a previous output again. |
| `output_format` | one of | png, jpeg | png | Output image format. |

## 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": "krea/v3/edit",
    "input": {
      "prompt": "A red fox curled up asleep in fresh snow at dawn, soft pink light on the pine trees behind it",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=krea%2Fv3%2Fedit

## Common questions

### Krea 3 Edit · Image Editing

**How much does Krea 3 Edit · Image Editing cost?**

Up to $0.26195 per run at the default inputs. Each item in `image_urls` adds $0.130975. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Krea 3 Edit · Image Editing through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "krea/v3/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 Krea 3 Edit · Image Editing?**

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

**Can my AI agent use Krea 3 Edit · Image Editing?**

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

