Documentation API, MeetingBrief

API synchrone : 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.

Téléversez un enregistrement de réunion et recevez dans la même réponse HTTP une transcription, un brief exécutif, un registre d’actions et un brouillon d’e-mail de suivi.

Point d’accès: POST https://mxprocess.com/api/files/start-process
Authentification: Bearer JWT obtenu depuis POST /api/login_check
Coût: 480 tokens par exécution réussie.

Requête

La requête doit être en multipart/form-data. Le champ parameters est une chaîne JSON et non un objet multipart imbriqué.

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=false'

Fichiers acceptés : MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV et AVI. Un seul enregistrement est accepté. language, audience et focus sont facultatifs ; les valeurs par défaut sont français, équipe projet et décisions/actions/risques/questions ouvertes.

Utilisez le mode synchrone seulement si votre client HTTP peut attendre la transcription et l’analyse. Pour les enregistrements longs, utilisez l’ API asynchrone.

Réponse réussie

Le champ output contient le brief structuré et downloadResults. Pour préserver la compatibilité avec le point d’accès synchrone existant, la demande persistée est sérialisée sous la "0" clé ; utilisez 0.id pour télécharger les fichiers via le point d’accès authentifié ci-dessous.

{
  "output": {
    "brief": {
      "title": "Weekly project review",
      "executive_summary": "...",
      "decisions": [{"decision": "...", "evidence": "..."}],
      "action_items": [{"task": "...", "owner": "", "due_date": "", "priority": "high", "evidence": "..."}],
      "risks": [],
      "open_questions": [],
      "follow_up_email": {"subject": "...", "body": "..."}
    },
    "downloadResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  },
  "0": {
    "id": 123,
    "accomplished": true,
    "actionResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  }
}

Télécharger un livrable

Remplacez ACTION_ID par l’identifiant de demande d’action renvoyé et utilisez le nom de fichier exact de downloadResults.

curl --location --request GET 'https://mxprocess.com/api/actions/download-action-result/ACTION_ID/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."
}

Nous contacter