API Documentation, Concatenate 2 to 15 videos into one MP4.

API : Concatenate 2 to 15 videos into one MP4.

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

API Documentation, VideoConcat

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.

The API sends a JSON response to confirm that the process is finished. Download the generated files with the authenticated URLs in actionResultsDownloadURLs.


{
    "actionResultsDownloadURLs": [
        "https://mxprocess.com/api/actions/download-result/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3/YOUR_TOKEN"
    ],
    "id": 1016,
    "actionParameters": [],
    "dateOfDemand": "2024-02-07T20:51:42+00:00",
    "startTime": "2024-02-07T20:51:46+01:00",
    "endTime": "2024-02-07T20:51:46+01:00",
    "hostedFileIds": [
        {
            "fileId": 1025,
            "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": [
        [
            "a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3",
            "https://mxprocessfiles.s3.eu-west-1.amazonaws.com/AudioToGPT/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3"
        ]
    ],
    "priceInTokensAtTimeOfUse": 15,
    "retryCount": 0,
    "executionPlannedAt": null,
    "trackingUrl": ""
}

Is this documentation unclear? (Python, PHP, Java, JavaScript...) Need help?