1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
import requests
import base64
# Use this function to convert an image file from the filesystem to base64
def image_file_to_base64(image_path):
with open(image_path, 'rb') as f:
image_data = f.read()
return base64.b64encode(image_data).decode('utf-8')
# Use this function to fetch an image from a URL and convert it to base64
def image_url_to_base64(image_url):
response = requests.get(image_url)
image_data = response.content
return base64.b64encode(image_data).decode('utf-8')
api_key = "YOUR_API_KEY"
url = "https://api.segmind.com/v1/superimpose"
# Request payload
data = {
"base_image": image_url_to_base64("https://segmind-sd-models.s3.amazonaws.com/display_images/tshirt+mock.jpg"), # Or use image_file_to_base64("IMAGE_PATH")
"overlay_image": image_url_to_base64("https://segmind-sd-models.s3.amazonaws.com/display_images/tshirt+logo.png"), # Or use image_file_to_base64("IMAGE_PATH")
"rescale_factor": 0.4,
"resize_method": "nearest-exact",
"overlay_resize": "Resize by rescale_factor",
"opacity": 1,
"height": 1024,
"width": 1024,
"x_offset": 320,
"y_offset": 620,
"rotation": 0,
"base64": False
}
headers = {'x-api-key': api_key}
response = requests.post(url, json=data, headers=headers)
print(response.content) # The response is the generated imageAttributes
Base image for the model
Overlay image for the model
Mask for the overlay image
Rescale factor for the overlay image
min : 0,
max : 16
Resize Method for Overlay Image.
Allowed values:
Overlay Image Resize
Allowed values:
Opacity of the Overlay Image
min : 0,
max : 1
Height
Width
X Offset
Y Offset
Rotation
min : 0,
max : 360
Base64 encoding of the output image.
To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.
Superimpose
Superimpose model lets you to create captivating visuals by seamlessly overlaying one image on top of another. It offers a user-friendly interface with granular control over placement and resizing, making it ideal for a variety of creative tasks.
Key Features of Superimpose
-
Intuitive Image Overlaying: Effortlessly combine two images to create unique compositions, perfect for photo collages, product mockups, and creative marketing materials.
-
Flexible Resizing Options:
-
Scale Factor: Resize the overlay image based on a specific multiplier, maintaining aspect ratio.
-
Height & Width: Set precise dimensions for the overlay image, independent of the scale factor.
-
None: Preserve the original size of the overlay image.
-
Fit: Automatically resize the overlay image to perfectly match the dimensions of the base image.
-
-
Advanced Resize Methods: Choose from various resizing algorithms to achieve your desired visual effect:
-
Bilinear: Creates smoother transitions by blending nearby pixels. Best for general image resizing.
-
Area: Provides exceptional image quality, particularly during downscaling, by prioritizing pixel area relationships.
-
Nearest: Offers faster processing but may result in a blocky appearance. Suitable for specific use cases where preserving sharp edges is crucial.
-
-
Precise Positioning: Utilize X-Offset and Y-Offset controls to meticulously position the overlay image on the base image, ensuring flawless alignment.
Popular Models
