Combine Two Images with AI

Official

flux-kontext-apps / multi-image-kontext-max

An experimental FLUX Kontext model that can combine two input images (Updated 2 weeks, 2 days ago)

Warm

Public
33.9K runs
$0.08 per output image
Commercial use

Iterate in playground

Run with an API

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

Put the woman into a white t-shirt with the text on itPut the woman into a white t-shirt with the text on it

Text description of how to combine or transform the two input images

input_image_1

*file

Preview

First input image. Must be jpeg, png, gif, or webp.

input_image_2

*file

Preview

Second input image. Must be jpeg, png, gif, or webp.

aspect_ratio

string

Aspect ratio of the generated image. Use 'match_input_image' to match the aspect ratio of the input image.

Default: "match_input_image"

seed

integer

Random seed. Set for reproducible generation

output_format

string

Output format for the generated image

Default: "png"

safety_tolerance

integer

(minimum: 0, maximum: 2)

Safety tolerance, 0 is most strict and 2 is most permissive. 2 is currently the maximum allowed.

Default: 2

Run this model in Node.js with one line of code:

npx create-replicate --model=flux-kontext-apps/multi-image-kontext-max

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";
import fs from "node:fs";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run flux-kontext-apps/multi-image-kontext-max using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const input = {
  prompt: "Put the woman into a white t-shirt with the text on it",
  aspect_ratio: "1:1",
  input_image_1: "https://replicate.delivery/pbxt/N5rSeJrCafWpmJuLb62moY8pSMEpSBBwSf7N6hxyIn4fNYMa/w8msa88d01rm80cq3hzsqrdehg.png",
  input_image_2: "https://replicate.delivery/pbxt/N5rSdTCgBqIRvbkedcfLfS5xTSEEOqMtX9FsR1hLK9JYryml/0_1.webp",
  output_format: "png",
  safety_tolerance: 2
};

const output = await replicate.run("flux-kontext-apps/multi-image-kontext-max", { input });

// To access the file URL:
console.log(output.url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run flux-kontext-apps/multi-image-kontext-max using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "flux-kontext-apps/multi-image-kontext-max",
    input={
        "prompt": "Put the woman into a white t-shirt with the text on it",
        "aspect_ratio": "1:1",
        "input_image_1": "https://replicate.delivery/pbxt/N5rSeJrCafWpmJuLb62moY8pSMEpSBBwSf7N6hxyIn4fNYMa/w8msa88d01rm80cq3hzsqrdehg.png",
        "input_image_2": "https://replicate.delivery/pbxt/N5rSdTCgBqIRvbkedcfLfS5xTSEEOqMtX9FsR1hLK9JYryml/0_1.webp",
        "output_format": "png",
        "safety_tolerance": 2
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run flux-kontext-apps/multi-image-kontext-max using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "input": {
      "prompt": "Put the woman into a white t-shirt with the text on it",
      "aspect_ratio": "1:1",
      "input_image_1": "https://replicate.delivery/pbxt/N5rSeJrCafWpmJuLb62moY8pSMEpSBBwSf7N6hxyIn4fNYMa/w8msa88d01rm80cq3hzsqrdehg.png",
      "input_image_2": "https://replicate.delivery/pbxt/N5rSdTCgBqIRvbkedcfLfS5xTSEEOqMtX9FsR1hLK9JYryml/0_1.webp",
      "output_format": "png",
      "safety_tolerance": 2
    }
  }' \
  https://api.replicate.com/v1/models/flux-kontext-apps/multi-image-kontext-max/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

Generated in

8.2 seconds

Tweak it Share Report View full prediction

Examples

View more examples

Readme

FLUX Kontext apps

Here at Replicate we’ve created a collection of models that are powered by FLUX Kontext [pro]. They can all be used commercially.

Available apps

Professional headshot: Generate a professional headshot from any image
Portrait series: Generate a series of portraits from a single image
Iconic locations: Put yourself in front of famous landmarks
Impossible Scenarios: Experience impossible adventures and extreme scenarios from a single image
Depth of Field: Bring your subjects into focus
Cartoonify: Turn your image into a cartoon
Text Removal: Remove all text from an image
Restore Image: Use FLUX Kontext to restore, fix scratches and damage, and colorize old photos

About FLUX Kontext

FLUX.1 Kontext is a state-of-the-art image editing model from Black Forest Labs that allows you to edit images using text prompts. It’s the best in class for text-guided image editing and offers superior results compared to other models like OpenAI’s 4o/gpt-image-1.

Available Models

FLUX.1 Kontext [pro]: State-of-the-art performance with high-quality outputs, great prompt following, and consistent results
FLUX.1 Kontext [max]: Premium model with maximum performance and improved typography generation