API Documentation, أنشئ مقاطع فيديو متكاملة بالذكاء الاصطناعي بعدة لغات، مع السرد والصوت والمشاهد المخصصة والموسيقى ومحرر متقدم متعدد المشاهد.

API : أنشئ مقاطع فيديو متكاملة بالذكاء الاصطناعي بعدة لغات، مع السرد والصوت والمشاهد المخصصة والموسيقى ومحرر متقدم متعدد المشاهد.

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

Action parameters

Send parameters as a JSON object. Required fields are marked with required.

sourceFileId — file.
imageSource — enum:ai,wikimedia_commons,user_images,ai_series_characters.
language — enum:en,fr,es,de,hi,zh,ar.
voiceGender — enum:male,female.
voiceName — string; maximum 120 characters.
watermarkText — string; maximum 80 characters.
longFormatVideo — boolean.
initialSceneFileId — file.
finalSceneFileId — file.
userImage1FileId — file.
userImage2FileId — file.
userImage3FileId — file.
userImage4FileId — file.
userImage5FileId — file.
automaticScript — boolean.
automaticScriptTopic — string; maximum 300 characters.
automaticScriptCountry — enum:FR,US,DE,ES,GB,EG,IN,CN,CA.
automaticScriptExcludeSport — boolean.
aiSeriesEpisodeId — integer; minimum 1.

curl --location 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/FILE_PATH/FILE_NAME"' \
--form 'actionName="GenerateAiVideo"' \
--form 'parameters={"sourceFileId":"example","imageSource":"ai","language":"en","voiceGender":"male","voiceName":"example","watermarkText":"example","longFormatVideo":false,"initialSceneFileId":"example","finalSceneFileId":"example","userImage1FileId":"example","userImage2FileId":"example","userImage3FileId":"example","userImage4FileId":"example","userImage5FileId":"example","automaticScript":false,"automaticScriptTopic":"example","automaticScriptCountry":"FR","automaticScriptExcludeSport":false,"aiSeriesEpisodeId":1}' \
--form 'async="false"' \
--form 'fileUrl=""' \
--form 'fileContent=""'

If your file is accessible by URL, you can ignore the "file=@.." field and directly use the URL of your file in the "fileUrl" field

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": "GenerateAiVideo",
        "slug": "GenerateAiVideo",
        "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 ?