← Catalog

creative.image_edit

live

Edit an existing image with a text instruction: swap backgrounds, change products, restyle, add or remove elements.

live coverage

fal: nano-banana-edit ✓flux-kontext ✓

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

ProviderStatus
fal live

Billing

Unit: per_image · unmatched results billed: no
Priced per output image. Image URLs are temporary; store what you keep.

The exact quote is returned by /v1/inspect before every call and held with headroom (1.5x the quote) on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills at about 1.43x cost (a 30% margin), never above the hold. The unused part of every hold is released.

Run it

curl https://api.routergrowth.com/v1/run \
  -H "Authorization: Bearer $ROUTERGROWTH_API_KEY" \
  -d '{
    "capability": "creative.image_edit",
    "input": { "prompt": "...", "image_url": "..." },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "count": {
      "default": 1,
      "description": "1 to 4 variations",
      "type": "integer"
    },
    "image_url": {
      "description": "Public URL of the source image",
      "type": "string"
    },
    "model": {
      "default": "nano-banana-edit",
      "description": "nano-banana-edit (Google) or flux-kontext (Black Forest Labs), $0.10 per image either way",
      "enum": [
        "nano-banana-edit",
        "flux-kontext"
      ],
      "type": "string"
    },
    "prompt": {
      "description": "The edit instruction",
      "type": "string"
    }
  },
  "required": [
    "prompt",
    "image_url"
  ],
  "type": "object"
}

Normalized output fields

prompt · model · images

Used in these use cases

Ad creative production →