API-Dokumentation, MeetingBrief

Synchrone API: KI-Meeting-Brief

Vor der Nutzung dieser API ist ein kostenloses Konto erforderlich. Erstellen und bestätigen Sie Ihr Konto unter /de/create-account, und beziehen Sie dann mit Ihren Zugangsdaten Ihr JWT.

Laden Sie eine Meeting-Aufnahme hoch und erhalten Sie in derselben HTTP-Antwort eine Transkription, ein Executive Briefing, ein Aktionsregister und einen Entwurf für die Follow-up-E-Mail.

Endpunkt: POST https://mxprocess.com/api/files/start-process
Authentifizierung: Bearer JWT bezogen von POST /api/login_check
Kosten: 480 tokens pro erfolgreicher Ausführung.

Anfrage

Die Anfrage muss multipart/form-data. Das Feld parameters eine JSON-Zeichenkette und kein verschachteltes Multipart-Objekt sein.

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'

Akzeptierte Dateien: MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV und AVI. Es wird nur eine Aufnahme akzeptiert. language, audience und focus sind optional; standardmäßig gelten Französisch, Projektteam und Entscheidungen/Aktionen/Risiken/offene Fragen.

Verwenden Sie den synchronen Modus nur, wenn Ihr HTTP-Client auf Transkription und Analyse warten kann. Für lange Aufnahmen verwenden Sie die asynchrone API.

Erfolgreiche Antwort

Das Feld output enthält das strukturierte Briefing und downloadResults. Aus Kompatibilitätsgründen mit dem bestehenden synchronen Endpunkt wird die gespeicherte Anfrage unter dem "0" Schlüssel serialisiert; verwenden Sie 0.id zum Herunterladen der Dateien über den authentifizierten Endpunkt unten.

{
  "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://..."]
    ]
  }
}

Lieferung herunterladen

Ersetzen Sie ACTION_ID durch die zurückgegebene Aktions-ID und verwenden Sie den exakten Dateinamen aus 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

Beispiel für einen fachlichen Fehler

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

Kontakt