This API is simple to use. You just have to follow these steps

• Create a free account
• Click on the link you receive by email to confirm your address
• Generate a token with credentials

You can use any language to make this CURL call. (Python, PHP, Java, JavaScript...) Need help ?

curl --location --request POST 'https://mxprocess.com/api/login_check' \ --header 'Content-Type: application/json' \ --data-raw '{"username":"YOUR_LOGIN","password":"YOUR_PASSWORD"}'

If your credentials are correct, our server will provide you with a token as a response : {"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}
YOUR_TOKEN is valid for one hour, its duration can be extended using YOUR_REFRESH_TOKEN


• Use the token to start the process asynchronously
Downloading results: when it is present in an API response, actionResultsDownloadURLs contains the authenticated URLs for downloading each generated result file.



Asynchronous API: video concatenation

Send 2 to 15 videos as file0 through file14, or send public URLs separated by | in fileUrl. Uploads and URLs may be combined. Each input is limited to 100 MB and 10 minutes; all inputs together are limited to 1 GB and 30 minutes.

Endpoint: POST https://mxprocess.com/api/files/start-process
Authentication: Bearer JWT
Cost: 15 tokens, charged only after success.

Upload files

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'file0=@/path/to/first.mp4' \ --form 'file1=@/path/to/second.mov' \ --form 'parameters=[]' \ --form 'async=true'

Public URLs

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'fileUrl=https://example.com/first.mp4|https://example.com/second.webm' \ --form 'parameters=[]' \ --form 'async=true'

Save the returned action ID and poll /api/actions/get-action-infos/{id} with the same JWT. When complete, actionResults contains one authenticated downloadable file named video-concat.mp4.

Initial response

{"id":123,"action":{"actionName":"VideoConcat","slug":"concat-video-online"},"accomplished":false,"actionResults":[],"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

Invalid cardinality, ownership, MIME/content, size or duration is rejected before processing with a stable VIDEO_CONCAT_* error.

Contact us


The API sends you a Json response to confirm that the process has started. take note of the "trackingUrl" field, it is the one that allows you to follow the process that you have launched. In this answer you also find the ID of your process, here in our example the ID is 643 : { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/643" }


• So to follow the progress, you do a simple GET(you can make this http call every 10 seconds):
curl --location 'https://mxprocess.com/api/actions/get-action-infos/643' \ --header 'Authorization: Bearer YOUR_TOKEN' }}

If the process is not yet completed, you will receive this type of response with "accomplished": false { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": null, "endTime": null, "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

If the process is completed, you will receive this type of response with "accomplished": true. The actionResultsDownloadURLs field contains the authenticated URLs for downloading the generated results: { "actionResultsDownloadURLs": [ "https://mxprocess.com/api/actions/download-result/643/35084b44a841ec597be3048df44145e8.txt.log/YOUR_TOKEN" ], "id": 643, "actionParameters": { "commandParameters": "" }, "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": "2024-01-28T11:24:49+01:00", "endTime": "2024-01-28T11:25:09+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": true, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [ [ "35084b44a841ec597be3048df44145e8.txt.log" ] ], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

Use each URL supplied in actionResultsDownloadURLs directly to download its corresponding result.

This documentation is not clear? (Python, PHP, Java, JavaScript...) Need help ?

Contact us This API is also available in synchronous mode : Developer API : VideoConcat