zsxkib/tool-merge-images:d933c835 | Run with an API on Replicate

Version

You're looking at a specific version of this model. Jump to the model overview.

zsxkib /tool-merge-images:d933c835

Playground API

Input

images

*file[]

Add multiple files

Images to merge (order preserved)

orientation

string

Direction of the strip

Default: "horizontal"

alignment

string

Alignment perpendicular to orientation

Default: "center"

resize_strategy

string

How to equalise sizes along the orientation axis

Default: "reduce_larger"

keep_aspect_ratio

boolean

Maintain aspect ratio when resizing

Default: true

border_thickness

integer

(minimum: 0)

Border thickness (px) — around and between images

Default: 0

border_color

string

Shift + Return to add a new line

Border colour (hex or Pillow keyword)

Default: "#ffffff"

output_format

string

Output format

Default: "webp"

output_quality

integer

(minimum: 1, maximum: 100)

Lossy quality 1-100 (ignored for PNG)

Default: 90

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

npx create-replicate --model=zsxkib/tool-merge-images

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 zsxkib/tool-merge-images using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "zsxkib/tool-merge-images:d933c8352ca7270ddf7c9c816e1c872f6114675ce43c8d70c924a3347bbeef05",
  {
    input: {
      alignment: "center",
      orientation: "horizontal",
      border_color: "#ffffff",
      output_format: "webp",
      output_quality: 90,
      resize_strategy: "reduce_larger",
      border_thickness: 0,
      keep_aspect_ratio: true
    }
  }
);

// 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 zsxkib/tool-merge-images using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "zsxkib/tool-merge-images:d933c8352ca7270ddf7c9c816e1c872f6114675ce43c8d70c924a3347bbeef05",
    input={
        "alignment": "center",
        "orientation": "horizontal",
        "border_color": "#ffffff",
        "output_format": "webp",
        "output_quality": 90,
        "resize_strategy": "reduce_larger",
        "border_thickness": 0,
        "keep_aspect_ratio": True
    }
)

# To access the file URL:
print(output.url())
#=> "http://example.com"

# To write the file to disk:
with open("my-image.png", "wb") as file:
    file.write(output.read())

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 zsxkib/tool-merge-images 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 $'{
    "version": "zsxkib/tool-merge-images:d933c8352ca7270ddf7c9c816e1c872f6114675ce43c8d70c924a3347bbeef05",
    "input": {
      "alignment": "center",
      "orientation": "horizontal",
      "border_color": "#ffffff",
      "output_format": "webp",
      "output_quality": 90,
      "resize_strategy": "reduce_larger",
      "border_thickness": 0,
      "keep_aspect_ratio": true
    }
  }' \
  https://api.replicate.com/v1/predictions

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

Output

No output yet! Press "Submit" to start a prediction.