Asynchrone 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.

Verwenden Sie diesen Modus für Meeting-Aufnahmen beliebiger Länge. Die API erstellt sofort eine Aktion; anschließend erzeugt der Worker im Hintergrund Transkript, Markdown-Bericht und strukturiertes JSON.

Endpunkt: POST https://mxprocess.com/api/files/start-process
Authentifizierung: Bearer JWT von POST /api/login_check
Kosten: 480 tokens, wird erst nach erfolgreicher Verarbeitung berechnet.

1. Aktion starten

Senden Sie eine Audio- oder Videodatei als multipart/form-data. Der Wert von parameters muss eine JSON-Zeichenkette 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=true'

Akzeptiert: MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV und AVI. Genau eine Aufnahme ist erforderlich. Die optionalen Parameter haben standardmäßig Französisch, Projektteam und Entscheidungen/Aktionen/Risiken/offene Fragen.

2. Erstantwort

Bewahren Sie die Aktions- id oder trackingUrl; die Aufnahme wurde zu diesem Zeitpunkt nur eingereiht.

{ "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. Status abrufen

Rufen Sie alle 10–15 Sekunden ab, bis accomplished zu true. Senden Sie die ursprüngliche Aufnahme während der Verarbeitung nicht erneut.

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. Ergebnis herunterladen

Verwenden Sie den exakten Dateinamen aus actionResults. Der authentifizierte Endpunkt funktioniert unabhängig davon, ob Objektspeicher aktiviert ist.

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

Beispiel für einen fachlichen Fehler

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

Benötigen Sie stattdessen eine sofortige Antwort? Verwenden Sie die synchrone API für kurze Aufnahmen.

Kontakt