Flux Kontext

# Flux Kontext Pro — Pro Pack on RunComfy

[runcomfy.com](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=flux-kontext) · [Model page](https://www.runcomfy.com/models/blackforestlabs/flux-1-kontext-pro/image-to-image?utm_source=skills.sh&utm_medium=skill&utm_campaign=flux-kontext) · [GitHub](https://github.com/agentspace-so/runcomfy-skills/tree/main/flux-kontext)

Black Forest Labs' **Flux 1 Kontext Pro** — single-reference precise local image edit — hosted on the **RunComfy Model API**. Strong prompt control, consistent outputs, high fidelity.

```bash
npx skills add agentspace-so/runcomfy-skills --skill flux-kontext -g
```

## When to pick this model (vs siblings)

| You want | Use |
|---|---|
| Single-image precise local edit ("she's now holding X") | **Flux Kontext** |
| High-fidelity preservation of source identity | **Flux Kontext** |
| Batch edits across 1–20 images | Nano Banana Edit |
| Edit multilingual / embedded text in image | GPT Image 2 edit |
| Generate from scratch, no source image | Flux 2 Klein |

If the user said "Flux Kontext" / "kontext" / "BFL Kontext" explicitly, route here regardless.

## Prerequisites

1. **RunComfy CLI** — `npm i -g @runcomfy/cli`
2. **RunComfy account** — `runcomfy login` opens a browser device-code flow.
3. **CI / containers** — set `RUNCOMFY_TOKEN=<token>` instead of `runcomfy login`.

## Endpoints + input schema

### `blackforestlabs/flux-1-kontext/pro/edit`

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `prompt` | string | yes | — | Single declarative edit instruction. |
| `image` | string | yes | — | Single source image URL (publicly fetchable HTTPS). |
| `aspect_ratio` | enum | no | (input) | Pick from supported W:H options on the model page. |
| `seed` | int | no | — | Reuse for variant comparisons. |

The schema is intentionally minimal — Kontext leans on prompt + single ref. For multi-image or web-grounded edits, route to Nano Banana Edit.

## How to invoke

**Default — local edit, preserve everything else:**

```bash
runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the person'\''s face, pose, and clothing unchanged. Add an orange umbrella in her left hand and a slight smile.",
    "image": "https://.../portrait.jpg"
  }' \
  --output-dir <absolute/path>
```

**With seed for reproducible variant series:**

```bash
runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the bottle, label, and lighting unchanged. Replace the brand text on the label from \"ALPHA\" to \"AURA\".",
    "image": "https://.../bottle.jpg",
    "seed": 42
  }' \
  --output-dir <absolute/path>
```

## Prompting — what actually works

**One declarative instruction.** Kontext shines on prompts shaped like the docs example: `"She is now holding an orange umbrella and smiling"`. Imperative mood, single change.

**Preservation first.** Lead with `"Keep [identity / pose / framing / brand] unchanged."` Then the change. Models honor what's stated up front.

**Single ref only — pick the right one.** No multi-image fanout here