Flux Kontext Dev

12 billion parameter model for editing images based on text instructions.

Flux Kontext Dev is a 12 billion parameter rectified flow transformer capable of editing images based on text instructions. It excels at making targeted edits to existing images while preserving the overall context and style.

Try in playground

Test Flux Kontext Dev in the Runpod Hub playground.

Endpoint	https://api.runpod.ai/v2/black-forest-labs-flux-1-kontext-dev/runsync
Pricing	$0.025 per image
Type	Image editing

Request

All parameters are passed within the input object in the request body.

input.prompt · string · required

Text instructions describing the desired edits to the image.

input.image · string · required

URL of the input image to edit.

input.negative_prompt · string

Elements to exclude from the edited image.

input.size · string · default: "1024*1024"

Output image size in format “width*height”.

input.num_inference_steps · integer · default: "28"

Number of denoising steps. Higher values produce more detailed edits. Range: 1-50.

input.guidance · float · default: "2"

How closely to follow the prompt. Range: 0.0-10.0.

input.seed · integer · default: "-1"

Seed for reproducible results. Set to -1 for random.

input.output_format · string · default: "png"

Output image format. Accepts png or jpeg.

input.enable_safety_checker · boolean · default: "true"

Whether to run safety checks on the output.

cURL

curl -X POST "https://api.runpod.ai/v2/black-forest-labs-flux-1-kontext-dev/runsync" \
  -H "Authorization: Bearer $RUNPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "Exact same bluebird, same angle and posture, now perched on a cloud in outer space",
      "image": "https://example.com/bluebird.png",
      "negative_prompt": "",
      "seed": -1,
      "num_inference_steps": 28,
      "guidance": 2,
      "size": "1024*1024",
      "output_format": "png",
      "enable_safety_checker": true
    }
  }'

import requests

response = requests.post(
    "https://api.runpod.ai/v2/black-forest-labs-flux-1-kontext-dev/runsync",
    headers={
        "Authorization": f"Bearer {RUNPOD_API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "input": {
            "prompt": "Exact same bluebird, same angle and posture, now perched on a cloud in outer space",
            "image": "https://example.com/bluebird.png",
            "negative_prompt": "",
            "seed": -1,
            "num_inference_steps": 28,
            "guidance": 2,
            "size": "1024*1024",
            "output_format": "png",
            "enable_safety_checker": True,
        }
    },
)

result = response.json()
print(result["output"]["image_url"])

const response = await fetch(
  "https://api.runpod.ai/v2/black-forest-labs-flux-1-kontext-dev/runsync",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${RUNPOD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      input: {
        prompt:
          "Exact same bluebird, same angle and posture, now perched on a cloud in outer space",
        image: "https://example.com/bluebird.png",
        negative_prompt: "",
        seed: -1,
        num_inference_steps: 28,
        guidance: 2,
        size: "1024*1024",
        output_format: "png",
        enable_safety_checker: true,
      },
    }),
  }
);

const result = await response.json();
console.log(result.output.image_url);

Response

id · string

Unique identifier for the request.

status · string

Request status. Returns COMPLETED on success, FAILED on error.

delayTime · integer

Time in milliseconds the request spent in queue before processing began.

executionTime · integer

Time in milliseconds the model took to edit the image.

workerId · string

Identifier of the worker that processed the request.

output · object

The generation result containing the image URL and cost.

output.image_url · string

URL of the edited image. This URL expires after 7 days.

output.cost · float

Cost of the generation in USD, calculated based on the output megapixels.

200

{
  "id": "sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890-u1",
  "status": "COMPLETED",
  "delayTime": 18,
  "executionTime": 4521,
  "workerId": "oqk7ao1uomckye",
  "output": {
    "image_url": "https://image.runpod.ai/abc123/output.png",
    "cost": 0.031457
  }
}

{
  "id": "sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890-u1",
  "status": "FAILED",
  "error": "Invalid image URL"
}

Image URLs expire after 7 days. Download and store edited images immediately if you need to keep them.

Cost calculation

Flux Kontext Dev charges $0.025 per image edited.