Video Concatenate Serverless API

Effortlessly merge videos with customized layouts, spacing, and audio for seamless content creation.

~31.67s
~$0.001
PlaygroundAPI
Pricing
 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/video-concatenate"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "video1": "https://segmind-resources.s3.amazonaws.com/input/sample1-sunflower.mp4",
12    "video2": "https://segmind-resources.s3.amazonaws.com/input/sample2.mp4",
13    "direction": "horizontal",
14    "spacing": 10,
15    "spacing_color": "#FFFFFF",
16    "size_adjustment": "reduce_biggest",
17    "audio_source": "video2",
18    "crf": 24,
19    "preset": "fast"
20}
21
22response = requests.post(url, headers=headers, json=data)
23
24if response.status_code == 200:
25    result = response.json()
26    print(json.dumps(result, indent=2))
27else:
28    print(f"Error: {response.status_code}")
29    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/video-concatenate

Parameters

video1required
string (uri)

First input video URL. Use high-quality videos for best output.

video2required
string (uri)

Second input video URL. Match quality with Video 1 for consistency.

audio_sourceoptional
string

Audio source choice. Use 'none' for silent output.

Default: "video2"
Allowed values :
"video1""video2""none"
crfoptional
integer

H.264 quality (CRF). Lower values for better quality, higher for smaller file.

Default: 24Range: 0 - 51
directionoptional
string

Concatenation direction. Use 'horizontal' for side-by-side, 'vertical' for stacking.

Default: "horizontal"
Allowed values :
"horizontal""vertical"
presetoptional
string

Encoding speed. 'Fast' saves time, 'Medium' for balance, 'Slow' for quality.

Default: "fast"
Allowed values :
"ultrafast""superfast""veryfast""faster""fast""medium""slow""slower""veryslow"
size_adjustmentoptional
string

Adjust size for uniformity. Use 'magnify_smallest' for smaller to match larger.

Default: "reduce_biggest"
Allowed values :
"magnify_smallest""reduce_biggest""crop_biggest"
spacingoptional
integer

Pixels space between videos. Increase for clear separation.

Default: 10Range: 0 - 2000
spacing_coloroptional
string

Color of spacing in hex. Use black (#000000) or white (#FFFFFF) for contrast.

Default: "#FFFFFF"

Response Type

Returns: Video

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