API 文档, MeetingBrief

异步 API：AI 会议简报

使用此 API 前需要免费账户。 请在 /zh/create-account, 创建并验证账户，然后使用凭据获取 JWT 令牌。

任何时长的会议录音都可以使用此模式。API 会立即创建操作，随后工作进程在后台生成转录、Markdown 报告和结构化 JSON。

端点: POST https://mxprocess.com/api/files/start-process
身份验证: Bearer JWT 来自 POST /api/login_check
费用: 480 tokens, 仅在处理成功后收取。

1. 启动操作

将一个音频或视频文件作为 multipart/form-data. 的值 parameters 必须是 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'

接受：MP3、WAV、M4A、AAC、OGG、FLAC、WebM、MP4、MOV、MKV 和 AVI。必须正好提供一段录音。可选参数默认值为法语、项目团队以及决策/行动/风险/待解决问题。

2. 初始响应

请保存操作的 id 或 trackingUrl; 此时录音仅已进入队列。

{
  "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. 轮询状态

每 10–15 秒轮询一次，直到 accomplished 变为 true. 处理期间不要重新提交原始录音。

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. 下载结果

使用 actionResults. 无论是否启用对象存储，经过身份验证的端点都可用。

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

功能错误示例

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

需要立即响应？短录音请改用同步 API 。

联系我们