API 文档, VideoLearningPack

异步 API：AI 视频学习包

上传一段教学视频。FFmpeg 提取语音和封面图；OpenAI 转录语音并生成讲师指南、学习目标、练习活动和知识检查。交付前请审阅生成的材料。

端点: POST https://mxprocess.com/api/files/start-process
身份验证: Bearer JWT 来自 POST /api/login_check
费用: 650 令牌，按现有成功操作生命周期扣除。

启动操作

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/path/to/safety-onboarding.mp4"' \
--form 'actionName="VideoLearningPack"' \
--form 'parameters=[["language",["English"]],["learnerProfile",["new team members"]],["learningGoal",["apply the safety procedure"]]]' \
--form 'async=true'

接受 MP4、MOV、MKV、WebM、AVI 和 M4V。上传一个不超过 1 GB 且带音轨的视频。保存 id，并轮询 /api/actions/get-action-infos/{id}。

{"id":123,"action":{"actionName":"VideoLearningPack","slug":"ai-video-learning-pack"},"accomplished":false,"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

完成后的 actionResults 包含转录 TXT、SRT 字幕、讲师指南 Markdown、知识检查 CSV、学习包 JSON 和 JPG 封面。请通过 /api/actions/download-action-result/123/FILENAME 下载所有文件，包括 JSON。

功能错误示例

{"error":"ERROR_VLP006 Video Learning Pack requires a video with an audio track."}

如果客户端可以等待，请使用同步 API.

联系我们