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

falImageAvailable nowReleased 2026-10-12

Krea 3 Edit · Image Editing

krea/v3/edit

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.

Pricing

$0.130975 per run. Each item in image_urls adds $0.130975.

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—

Description of the image to generate.

image_urls requiredURLs or files—

Reference images to edit or combine (1-8). Order sets the <image-N> tags.

modelone of
berry, jam
berry

Model variant: berry favors quality, jam favors speed.

image_sizeJSONauto

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_levelone 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_prompttext

What to keep out of the image. Used by berry only.

seednumber (whole)—

Latent noise seed. Use a new seed when editing a previous output again.

output_formatone of
png, jpeg
png

Output image format.

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

Frequently asked questions

How much does Krea 3 Edit · Image Editing cost?

$0.130975 per run. 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.