Skip to main content
POST
/
remix
import requests
import json

API_KEY = "your-api-key-here"
BASE_URL = "https://www.topyappers.com"
VIDEO_PATH = "/path/to/your/video.mp4"

# Optional parameters for video processing
parameters = {
"playbackSpeed": 1.2,
"brightness": 0.1,
"contrast": 1.1,
"saturation": 1.2,
"hue": 15,
"zoomFactor": 1.05
}

url = f"{BASE_URL}/api/v1/remix"

headers = {
"x-ty-api-key": API_KEY,
}

files = {
"video": open(VIDEO_PATH, "rb")
}

data = {
"parameters": json.dumps(parameters)
}

response = requests.post(url, headers=headers, files=files, data=data)

if response.status_code == 200:
result = response.json()
print("Success!")
print(f"Input URL: {result['data']['inputVideoUrl']}")
{
"success": true,
"message": "Video processed successfully",
"data": {
"inputVideoUrl": "https://storage.topyappers.com/uploads/video-abc123.mp4",
"originalFilename": "my-video.mp4",
"parameters": {
"playbackSpeed": 1.2,
"brightness": 0.1,
"contrast": 1.1,
"saturation": 1.2,
"hue": 15,
"zoomFactor": 1.05
},
"result": {
"status": "processing",
"processingId": "proc_xyz789",
"estimatedTime": 60
}
}
}

Authorizations

x-ty-api-key
string
header
required

API key for TopYappers API authentication

Body

multipart/form-data
video
file
required

The video file to upload (MP4, MOV, AVI, etc.). In Python requests, use files={'video': open(path, 'rb')}

parameters
string

JSON stringified object containing processing parameters. In Python requests, use data={'parameters': json.dumps(params)}

Example:

"{\"playbackSpeed\": 1.2, \"brightness\": 0.1, \"contrast\": 1.1, \"saturation\": 1.2, \"hue\": 15, \"zoomFactor\": 1.05}"

Response

Video remixed successfully

data
object
I