Flux kontext Image to Image

Generate image from text and reference images (Flux Kontext Model)

curl --request POST \
  --url https://modelslab.com/api/v6/images/img2img \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "model_id": "flux-kontext-dev",
  "prompt": "<string>",
  "init_image": "<string>",
  "negative_prompt": "<string>",
  "init_image_2": "<string>",
  "safety_checker": true,
  "num_inference_steps": "28",
  "strength": "0.5",
  "guidance": "2.5",
  "enhance_prompt": true,
  "width": 512,
  "height": 512,
  "samples": 1,
  "seed": 123,
  "base64": false,
  "webhook": "<string>",
  "track_id": "<string>",
  "temp": false
}
'

import requests

url = "https://modelslab.com/api/v6/images/img2img"

payload = {
    "key": "<string>",
    "model_id": "flux-kontext-dev",
    "prompt": "<string>",
    "init_image": "<string>",
    "negative_prompt": "<string>",
    "init_image_2": "<string>",
    "safety_checker": True,
    "num_inference_steps": "28",
    "strength": "0.5",
    "guidance": "2.5",
    "enhance_prompt": True,
    "width": 512,
    "height": 512,
    "samples": 1,
    "seed": 123,
    "base64": False,
    "webhook": "<string>",
    "track_id": "<string>",
    "temp": False
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: '<string>',
    model_id: 'flux-kontext-dev',
    prompt: '<string>',
    init_image: '<string>',
    negative_prompt: '<string>',
    init_image_2: '<string>',
    safety_checker: true,
    num_inference_steps: '28',
    strength: '0.5',
    guidance: '2.5',
    enhance_prompt: true,
    width: 512,
    height: 512,
    samples: 1,
    seed: 123,
    base64: false,
    webhook: '<string>',
    track_id: '<string>',
    temp: false
  })
};

fetch('https://modelslab.com/api/v6/images/img2img', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://modelslab.com/api/v6/images/img2img",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'key' => '<string>',
    'model_id' => 'flux-kontext-dev',
    'prompt' => '<string>',
    'init_image' => '<string>',
    'negative_prompt' => '<string>',
    'init_image_2' => '<string>',
    'safety_checker' => true,
    'num_inference_steps' => '28',
    'strength' => '0.5',
    'guidance' => '2.5',
    'enhance_prompt' => true,
    'width' => 512,
    'height' => 512,
    'samples' => 1,
    'seed' => 123,
    'base64' => false,
    'webhook' => '<string>',
    'track_id' => '<string>',
    'temp' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://modelslab.com/api/v6/images/img2img"

	payload := strings.NewReader("{\n  \"key\": \"<string>\",\n  \"model_id\": \"flux-kontext-dev\",\n  \"prompt\": \"<string>\",\n  \"init_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"init_image_2\": \"<string>\",\n  \"safety_checker\": true,\n  \"num_inference_steps\": \"28\",\n  \"strength\": \"0.5\",\n  \"guidance\": \"2.5\",\n  \"enhance_prompt\": true,\n  \"width\": 512,\n  \"height\": 512,\n  \"samples\": 1,\n  \"seed\": 123,\n  \"base64\": false,\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\",\n  \"temp\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://modelslab.com/api/v6/images/img2img")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"<string>\",\n  \"model_id\": \"flux-kontext-dev\",\n  \"prompt\": \"<string>\",\n  \"init_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"init_image_2\": \"<string>\",\n  \"safety_checker\": true,\n  \"num_inference_steps\": \"28\",\n  \"strength\": \"0.5\",\n  \"guidance\": \"2.5\",\n  \"enhance_prompt\": true,\n  \"width\": 512,\n  \"height\": 512,\n  \"samples\": 1,\n  \"seed\": 123,\n  \"base64\": false,\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\",\n  \"temp\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://modelslab.com/api/v6/images/img2img")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"<string>\",\n  \"model_id\": \"flux-kontext-dev\",\n  \"prompt\": \"<string>\",\n  \"init_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"init_image_2\": \"<string>\",\n  \"safety_checker\": true,\n  \"num_inference_steps\": \"28\",\n  \"strength\": \"0.5\",\n  \"guidance\": \"2.5\",\n  \"enhance_prompt\": true,\n  \"width\": 512,\n  \"height\": 512,\n  \"samples\": 1,\n  \"seed\": 123,\n  \"base64\": false,\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\",\n  \"temp\": false\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "generationTime": 123,
  "id": 123,
  "output": [
    "<string>"
  ],
  "proxy_links": [
    "<string>"
  ],
  "meta": {},
  "nsfw_content_detected": true
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

POST

images

img2img

Generate image from text and reference images (Flux Kontext Model)

curl --request POST \
  --url https://modelslab.com/api/v6/images/img2img \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "model_id": "flux-kontext-dev",
  "prompt": "<string>",
  "init_image": "<string>",
  "negative_prompt": "<string>",
  "init_image_2": "<string>",
  "safety_checker": true,
  "num_inference_steps": "28",
  "strength": "0.5",
  "guidance": "2.5",
  "enhance_prompt": true,
  "width": 512,
  "height": 512,
  "samples": 1,
  "seed": 123,
  "base64": false,
  "webhook": "<string>",
  "track_id": "<string>",
  "temp": false
}
'

import requests

url = "https://modelslab.com/api/v6/images/img2img"

payload = {
    "key": "<string>",
    "model_id": "flux-kontext-dev",
    "prompt": "<string>",
    "init_image": "<string>",
    "negative_prompt": "<string>",
    "init_image_2": "<string>",
    "safety_checker": True,
    "num_inference_steps": "28",
    "strength": "0.5",
    "guidance": "2.5",
    "enhance_prompt": True,
    "width": 512,
    "height": 512,
    "samples": 1,
    "seed": 123,
    "base64": False,
    "webhook": "<string>",
    "track_id": "<string>",
    "temp": False
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    key: '<string>',
    model_id: 'flux-kontext-dev',
    prompt: '<string>',
    init_image: '<string>',
    negative_prompt: '<string>',
    init_image_2: '<string>',
    safety_checker: true,
    num_inference_steps: '28',
    strength: '0.5',
    guidance: '2.5',
    enhance_prompt: true,
    width: 512,
    height: 512,
    samples: 1,
    seed: 123,
    base64: false,
    webhook: '<string>',
    track_id: '<string>',
    temp: false
  })
};

fetch('https://modelslab.com/api/v6/images/img2img', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://modelslab.com/api/v6/images/img2img",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'key' => '<string>',
    'model_id' => 'flux-kontext-dev',
    'prompt' => '<string>',
    'init_image' => '<string>',
    'negative_prompt' => '<string>',
    'init_image_2' => '<string>',
    'safety_checker' => true,
    'num_inference_steps' => '28',
    'strength' => '0.5',
    'guidance' => '2.5',
    'enhance_prompt' => true,
    'width' => 512,
    'height' => 512,
    'samples' => 1,
    'seed' => 123,
    'base64' => false,
    'webhook' => '<string>',
    'track_id' => '<string>',
    'temp' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://modelslab.com/api/v6/images/img2img"

	payload := strings.NewReader("{\n  \"key\": \"<string>\",\n  \"model_id\": \"flux-kontext-dev\",\n  \"prompt\": \"<string>\",\n  \"init_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"init_image_2\": \"<string>\",\n  \"safety_checker\": true,\n  \"num_inference_steps\": \"28\",\n  \"strength\": \"0.5\",\n  \"guidance\": \"2.5\",\n  \"enhance_prompt\": true,\n  \"width\": 512,\n  \"height\": 512,\n  \"samples\": 1,\n  \"seed\": 123,\n  \"base64\": false,\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\",\n  \"temp\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://modelslab.com/api/v6/images/img2img")
  .header("Content-Type", "application/json")
  .body("{\n  \"key\": \"<string>\",\n  \"model_id\": \"flux-kontext-dev\",\n  \"prompt\": \"<string>\",\n  \"init_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"init_image_2\": \"<string>\",\n  \"safety_checker\": true,\n  \"num_inference_steps\": \"28\",\n  \"strength\": \"0.5\",\n  \"guidance\": \"2.5\",\n  \"enhance_prompt\": true,\n  \"width\": 512,\n  \"height\": 512,\n  \"samples\": 1,\n  \"seed\": 123,\n  \"base64\": false,\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\",\n  \"temp\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://modelslab.com/api/v6/images/img2img")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"key\": \"<string>\",\n  \"model_id\": \"flux-kontext-dev\",\n  \"prompt\": \"<string>\",\n  \"init_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"init_image_2\": \"<string>\",\n  \"safety_checker\": true,\n  \"num_inference_steps\": \"28\",\n  \"strength\": \"0.5\",\n  \"guidance\": \"2.5\",\n  \"enhance_prompt\": true,\n  \"width\": 512,\n  \"height\": 512,\n  \"samples\": 1,\n  \"seed\": 123,\n  \"base64\": false,\n  \"webhook\": \"<string>\",\n  \"track_id\": \"<string>\",\n  \"temp\": false\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "generationTime": 123,
  "id": 123,
  "output": [
    "<string>"
  ],
  "proxy_links": [
    "<string>"
  ],
  "meta": {},
  "nsfw_content_detected": true
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

Request

Make a POST request to below endpoint and pass the required parameters as a request body.

curl

--request POST 'https://modelslab.com/api/v6/images/img2img' \

Body

json

{
  "key": "your_api_key",
  "init_image": "https://assets.modelslab.ai/generations/197fdb87-3d94-4a3d-bf2b-6c1b2a73a623",
  "init_image_2": "https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/generations/output.jpg",
  "prompt": "a girl from image one holding the can from image two",
  "negative_prompt": "(worst quality:2), (low quality:2), (normal quality:2), (jpeg artifacts), (blurry), (duplicate), (morbid), (mutilated), (out of frame), (extra limbs), (bad anatomy), (disfigured), (deformed), (cross-eye), (glitch), (oversaturated), (overexposed), (underexposed), (bad proportions), (bad hands), (bad feet), (cloned face), (long neck), (missing arms), (missing legs), (extra fingers), (fused fingers), (poorly drawn hands), (poorly drawn face), (mutation), (deformed eyes), watermark, text, logo, signature, grainy, tiling, censored, nsfw, ugly, blurry eyes, noisy image, bad lighting, unnatural skin, asymmetry",
  "model_id": "flux-kontext-dev",
  "num_inference_steps": "28",
  "safety_checker": true,
  "strength": "0.5",
  "guidance": "2.5",
  "enhance_prompt": null
}

Body

application/json

key

string

required

Your API Key used for request authorization.

model_id

string

default:flux-kontext-dev

required

The ID of the model. Must be 'flux-kontext-dev' for Flux Kontext model.

prompt

string

required

A text description of the things you want in the generated image, referencing elements from the input images.

init_image

string<uri>

required

URL of the primary reference image to use as a base for the generation.

negative_prompt

string

Items you don't want in the image. Helps exclude unwanted elements, artifacts, or styles from the generation.

init_image_2

string<uri>

URL of the secondary reference image to incorporate elements from. Optional for single-image workflows.

safety_checker

boolean

Whether to run the safety checker

num_inference_steps

default:28

The number of denoising steps. Values typically range from 1 to 50. Can be provided as integer or string.

Required range: 1 <= x <= 50

strength

default:0.5

Controls how much the output image should resemble the input image. 0.0 means identical to input, 1.0 means completely different. Can be provided as number or string.

Required range: 0 <= x <= 1

guidance

default:2.5

Scale for classifier-free guidance. Higher values make the model follow the prompt more closely. Can be provided as number or string.

Required range: 0 <= x <= 20

enhance_prompt

boolean | null

Enhance prompts for better results. Set to null to use model defaults.

width

integer

default:512

The width of the output image in pixels. Maximum value is 1024.

Required range: x <= 1024

height

integer

default:512

The height of the output image in pixels. Maximum value is 1024.

Required range: x <= 1024

samples

integer

default:1

The number of images to be returned in response. Maximum value is 4.

Required range: x <= 4

seed

integer | null

Used to reproduce results. The same seed will generate the same image again. Pass null for a random number.

base64

boolean

default:false

Get response as a base64 string.

webhook

string<uri>

URL to receive a POST API call once image generation is complete.

track_id

string

This ID is returned in the response to the webhook API call and is used to identify the webhook request.

temp

boolean

default:false

Create a temporary image link valid for 24 hours.

Response

Flux Kontext Image to Image generation response

Option 1
Option 2
Option 3

status

enum<string>

Status of the image generation.

Available options:

success

generationTime

number

Time taken to generate the image in seconds.

integer

Unique identifier for the image generation request.

output

string<uri>[]

Array of generated image URLs.

proxy_links

string<uri>[]

Array of proxy image URLs.

Using the APIs

Our AI APIs

Flux kontext Image to Image

Request

Body

Body

Response

​Request

​Body

Body

Response

Request

Body