Edit Image with Kontext: Black Forest Labs action

Inputs

The fields this action accepts.

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

Field	Type	Required	Description
Model model	options	Optional	Model. Options: Flux Kontext Pro, Flux Kontext Max
Edit Prompt prompt	string	Required	make the sky purple at sunset
Input Image (base64 or URL) input_image	string	Required	Input Image (base64 or URL) (required)
Aspect Ratio aspect_ratio	string	Optional	Aspect 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.

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. Tiny Command handles Black Forest Labs's rate limits automatically so you don't have to throttle manually.

More actions