MXPROCESS

Asynchronous API: AI Meeting Brief

A free account is required before using this API. Create and validate your account on /zh/create-account, then obtain your JWT token with your credentials.

Use this mode for meeting recordings of any duration. The API immediately creates an action, then the worker produces the transcript, Markdown report and structured JSON in the background.

Endpoint: POST https://mxprocess.com/api/files/start-process
Authentication: Bearer JWT from POST /api/login_check
Cost: 18 tokens, charged only after successful processing.

1. Start the action

Send one audio or video file as multipart/form-data. The parameters value must be a JSON string.

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'

Accepted: MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV and AVI. Exactly one recording is required. The optional parameters default to French, project team, and decisions/actions/risks/open questions.

2. Initial response

Keep the action id or trackingUrl; the recording has only been queued at this stage.

{
  "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. Poll status

Poll every 10–15 seconds until accomplished becomes true. Do not resubmit the original recording while processing.

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. Download a result

Use the exact filename from actionResults. The authenticated endpoint works whether object storage is enabled or not.

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

Functional error example

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

Need an immediate response instead? Use the synchronous API for short recordings.