MXPROCESS

API : Turn one spoken video into professionally translated SRT and WebVTT captions with a localization quality register.

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

curl --location 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/FILE_PATH/product-demo.mp4"' \
--form 'actionName="VideoLocalizationPack"' \
--form 'parameters=[["sourceLanguage",["English"]],["targetLanguage",["French"]],["audience",["product buyers"]]]' \
--form 'async="true"'

Upload exactly one MP4, MOV, MKV, WebM, AVI or M4V video with an audio track. sourceLanguage may be Auto-detect from video; targetLanguage and audience are bounded text values. The asynchronous response returns an action id and tracking URL. Poll it until accomplished is true, then download each SRT, VTT, CSV, TXT or JSON result using the authenticated download endpoint.

The API sends you a Json response to confirm that the process is finished.
In this Json, the most important for you is the block: "actionResults",
you will find in this block a URL which begins with "https://mxprocessfiles.s3.eu-west-1.amazonaws.com...", it is this URL that allows you to download the result


{
    "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": "VideoLocalizationPack",
        "slug": "ai-video-localization-pack",
        "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": ""
}

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