Flux Kontext Dev

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);

{
  "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"
}

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.

string

required

Text instructions describing the desired edits to the image.

string

required

URL of the input image to edit.

string

Elements to exclude from the edited image.

string

default:"1024*1024"

Output image size in format “width*height”.

integer

default:"28"

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

float

default:"2"

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

integer

default:"-1"

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

string

default:"png"

Output image format. Accepts png or jpeg.

boolean

default:"true"

Whether to run safety checks on the output.

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

string

Unique identifier for the request.

string

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

integer

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

integer

Time in milliseconds the model took to edit the image.

string

Identifier of the worker that processed the request.

object

The generation result containing the image URL and cost.

string

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

float

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

{
  "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.

Last modified on October 5, 2026

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);

{
  "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 models

Video models

Text models

Audio models

Try in playground

Request

Response

Cost calculation