← Catalog

AI image editing API: swap backgrounds, products and styles by instruction

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 on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.jell.run/v1/run \
  -H "Authorization: Bearer $JELL_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) $0.06825 or flux-kontext (Black Forest Labs) $0.07, per output image",
      "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 guides

Ad creative production →