Multi Image Kontext Pro Serverless API

Transform text into stunning, professional-grade images with precise editing capabilities.

~22.91s
$0.05 per generation
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/multi-image-kontext-pro"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "prompt": "A woman is taking a selfie with the man in front of the Taj Mahal.",
12    "aspect_ratio": "1:1",
13    "input_image_1": "https://segmind-resources.s3.amazonaws.com/output/80b5e919-9150-43eb-a07c-b56f73ea3dcb-image_31.png",
14    "input_image_2": "https://segmind-resources.s3.amazonaws.com/output/9c4b025f-dad6-4dae-88ab-d01765f0c2b8-man2.png",
15    "output_format": "png",
16    "safety_tolerance": 2
17}
18
19response = requests.post(url, headers=headers, json=data)
20
21if response.status_code == 200:
22    result = response.json()
23    print(json.dumps(result, indent=2))
24else:
25    print(f"Error: {response.status_code}")
26    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/multi-image-kontext-pro

Parameters

input_image_1required
string (uri)

Provide the first image URL.

input_image_2required
string (uri)

Provide the second image URL.

Default: "https://segmind-resources.s3.amazonaws.com/output/9c4b025f-dad6-4dae-88ab-d01765f0c2b8-man2.png"
promptrequired
string

Describe how to transform images.

Default: "A woman is taking a selfie with the man in front of the Taj Mahal."
aspect_ratiooptional
string

Choose the output aspect ratio. '16:9' for widescreen or '1:1' for square images.

Default: "match_input_image"
Allowed values (14 total):
"match_input_image""1:1""16:9""9:16""4:3""3:4""3:2""2:3""4:5""5:4"+4 more
output_formatoptional
string

Select the output file format. Use 'png' for high quality or 'jpg' for smaller file size.

Default: "png"
Allowed values :
"jpg""png"
safety_toleranceoptional
integer

Adjust safety levels: '0' for strict filtering, '2' for more lenient results.

Default: 2Range: 0 - 2
seedoptional
integer

Set a random seed for reproducibility. leave blank for random outcomes.

Default: null

Response Type

Returns: Image

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out