Start free
ActionBlack Forest LabsUpdated June 2026

How do I edit an image with Flux Kontext?

Short answer: You can edit image with kontext in Black Forest Labs by hand from its own interface, but it won’t repeat itself. On TinyCommand, add the Black Forest Labs Edit Image with Kontext action to a workflow, map its 4 inputs from any upstream app, and it runs automatically every time the trigger fires. No code, and a free tier to start.

Edit Image with Kontext in Black Forest Labs — start free All 4 Black Forest Labs actions
Edit Image with Kontext in Black Forest Labs — start free
Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Model
model
optionsOptionalModel. Options: Flux Kontext Pro, Flux Kontext Max
Edit Prompt
prompt
stringRequiredmake the sky purple at sunset
Input Image (base64 or URL)
input_image
stringRequiredInput Image (base64 or URL) (required)
Aspect Ratio
aspect_ratio
stringOptionalAspect Ratio
Sample request
{
  "model": "{{trigger.model}}",
  "prompt": "make the sky purple at sunset",
  "input_image": "{{trigger.input_image}}",
  "aspect_ratio": "{{trigger.aspect_ratio}}"
}
Returns
{
  "id": "task_abc",
  "polling_url": "https://api.bfl.ai/v1/get_result?id=task_abc"
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Edit Image with Kontext.

Any of these apps can fire this action as part of a workflow.

Gmail → Black Forest Labs
1 Gmail triggers
Slack → Black Forest Labs
13 Slack triggers
Google Sheets → Black Forest Labs
2 Google Sheets triggers
HubSpot → Black Forest Labs
18 HubSpot triggers
FAQ

Questions about Edit Image with Kontext.

What does the Edit Image with Kontext action do in Black Forest Labs?
Takes a source image plus a text instruction ("make the sky stormy", "remove the person on the left"). Flux Kontext preserves the unchanged parts and applies the requested edit. Better at "keep this thing, change that thing" than re-generating from scratch with a reference image.
What inputs does Edit Image with Kontext require?
Required: Edit Prompt, Input Image (base64 or URL). Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Black Forest Labs returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does Edit Image with Kontext support batch operations?
Yes. Run Edit Image with Kontext inside a Loop node to process arrays. TinyCommand handles Black Forest Labs's rate limits automatically so you don't have to throttle manually.
More actions

Other Black Forest Labs actions.

Action
Inpaint with Flux Fill
Mask-driven inpainting — pass an input image, a black-and-white mask (white = regenerate, black = preserve), and a prompt describing what should fill the white area. Flux Fill regenerates only the masked region while preserving everything else. The standard tool for removing unwanted objects or replacing specific areas.
Action
Generate Image with Flux
Text-to-image generation across Flux variants (Schnell for fastest/cheapest, Dev for open-weights, Pro for highest quality, Ultra for strongest text rendering). Returns a task ID; poll Get Result for the finished image URL.
Action
Get Generation Result
Polls a task ID for status; returns the image URL in result.sample once status is Ready. For production, configure BFL's webhook on the generation request to skip polling and get a push notification when ready.
Edit Image with Kontext in Black Forest Labs — start free