Documentation API, Transformez un enregistrement de podcast audio ou vidéo en extraits verticaux sous-titrés.

Accueil Tarifs Paramètres Nous contacter

API : Transformez un enregistrement de podcast audio ou vidéo en extraits verticaux sous-titrés.

Cette API est simple à utiliser. Il vous suffit de suivre ces étapes

Créer un compte gratuitement
Cliquez sur le lien reçu par e-mail pour confirmer votre adresse.
Générer un jeton avec vos identifiants

Vous pouvez utiliser n’importe quel langage pour effectuer cet appel CURL. (Python, PHP, Java, JavaScript...) Besoin d’aide ?

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

Si vos identifiants sont corrects, notre serveur vous fournira un jeton en réponse :

{"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}

YOUR_TOKEN est valide pendant une heure ; sa durée peut être prolongée avec YOUR_REFRESH_TOKEN.

Utilisez le jeton pour démarrer le traitement

Paramètres de l’action

Envoyez parameters comme objet JSON. Les champs obligatoires sont marqués obligatoire.

clipCount — integer; minimum 1; maximum 6.
targetDuration — integer; minimum 15; maximum 60.
language — enum:auto,en,fr,es,de,hi,zh,ar.
platform — enum:youtube_shorts,tiktok,instagram_reels,facebook_reels,x,linkedin.
subtitleStyle — enum:classic,alex_hormozi,mrbeast,minimal,bold,podcast,custom.
podcastTitle — string; maximum 160 caractères.
subtitles — boolean.
maximumClips — boolean.
highlightReel — boolean.
rightsConfirmed — boolean; obligatoire.

curl --location 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/FILE_PATH/FILE_NAME"' \
--form 'actionName="PodcastClipGenerator"' \
--form 'parameters={"clipCount":1,"targetDuration":15,"language":"auto","platform":"youtube_shorts","subtitleStyle":"classic","podcastTitle":"example","subtitles":false,"maximumClips":false,"highlightReel":false,"rightsConfirmed":false}' \
--form 'async="false"' \
--form 'fileUrl=""' \
--form 'fileContent=""'

Si votre fichier est accessible par URL, ignorez le champ « file=@.. » et utilisez directement son URL dans le champ « fileUrl ».

L’API renvoie une réponse JSON confirmant la fin du traitement. Téléchargez les fichiers générés avec les URL authentifiées de 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": "PodcastClipGenerator",
        "slug": "podcast-clip-generator",
        "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": ""
}

Cette documentation n’est pas claire ? (Python, PHP, Java, JavaScript...) Besoin d’aide ?

Nous contacter Cette API est également disponible en mode asynchrone : API développeur : PodcastClipGenerator