API asynchrone : brief de réunion par IA

Un compte gratuit est requis avant d’utiliser cette API. Créez et validez votre compte sur /fr/create-account, puis obtenez votre jeton JWT avec vos identifiants.

Utilisez ce mode pour des enregistrements de réunion de toute durée. L’API crée immédiatement une action, puis le worker produit en arrière-plan la transcription, le rapport Markdown et le JSON structuré.

Point d’accès: POST https://mxprocess.com/api/files/start-process
Authentification: Bearer JWT depuis POST /api/login_check
Coût: 480 tokens, facturés uniquement après un traitement réussi.

1. Démarrer l’action

Envoyez un fichier audio ou vidéo en multipart/form-data. La valeur de parameters doit être une chaîne JSON.

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --header 'Accept: application/json' \ --form 'file=@"/absolute/path/weekly-review.mp4"' \ --form 'actionName=MeetingBrief' \ --form 'parameters=[["language",["French"]],["audience",["project team"]],["focus",["decisions, actions, risks and open questions"]]]' \ --form 'async=true'

Accepté : MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV et AVI. Un seul enregistrement est requis. Les paramètres facultatifs prennent par défaut les valeurs français, équipe projet et décisions/actions/risques/questions ouvertes.

2. Réponse initiale

Conservez l’ id ou l’ trackingUrl; l’enregistrement est seulement mis en file à ce stade.

{ "id": 123, "actionParameters": [["language", ["French"]]], "hostedFileIds": [{"fileId": 456, "parameters": ""}], "action": {"actionName": "MeetingBrief", "slug": "ai-meeting-brief"}, "accomplished": false, "actionResults": [], "priceInTokensAtTimeOfUse": 18, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/123" }

3. Suivre l’état

Interrogez toutes les 10 à 15 secondes jusqu’à ce que accomplished devienne true. Ne renvoyez pas l’enregistrement original pendant le traitement.

curl --location --request GET 'https://mxprocess.com/api/actions/get-action-infos/123' \ --header 'Authorization: Bearer YOUR_TOKEN' { "id": 123, "accomplished": true, "actionResults": [ ["weekly-review-transcript.txt", "https://..."], ["weekly-review-meeting-brief.md", "https://..."], ["weekly-review-meeting-brief.json", "https://..."] ], "priceInTokensAtTimeOfUse": 18 }

4. Télécharger un résultat

Utilisez le nom de fichier exact de actionResults. Le point d’accès authentifié fonctionne avec ou sans stockage objet.

curl --location --request GET 'https://mxprocess.com/api/actions/download-action-result/123/weekly-review-meeting-brief.json' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --output weekly-review-meeting-brief.json

Exemple d’erreur fonctionnelle

{ "error": "ERROR_MB004 MeetingBrief accepts audio or video recordings only." }

Besoin d’une réponse immédiate ? Utilisez plutôt l’ API synchrone pour les enregistrements courts.

Nous contacter