API 文档, ShortFormVideoStudio

异步 API：AI 短视频工作室

从自由文本、文章 URL 或一至三个文档生成 1080×1920 社交视频包。Worker 提取来源、规划场景、生成视觉内容和 OpenAI 旁白，创建 SRT 与 VTT 字幕，使用 FFmpeg 渲染 MP4，并返回全部项目资源供下载。

端点: 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 'fileContent=Paste the article or your short video script here.' \
--form 'actionName=ShortFormVideoStudio' \
--form 'parameters=[["language",["English"]],["audience",["startup founders"]],["platform",["TikTok and YouTube Shorts"]],["durationSeconds",["45"]]]' \
--form 'async=true'

替代来源：发送 file=@"/path/to/source.pdf", 最多三个 file0..file2 文档字段, 或使用 fileUrl=https://example.com/article 并使用 extractDataFromHtml=true. 接受的文档：PDF、DOCX、TXT、Markdown、HTML 和常见扫描图像。完成后的结果包括 MP4、JPG、TXT、JSON、SRT 和 VTT；每个文件都作为附件下载。

初始响应

{"id":123,"action":{"actionName":"ShortFormVideoStudio","slug":"ai-short-form-video-studio"},"accomplished":false,"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

功能错误示例

{"error":"ERROR_SFVS005 Short-Form Video Studio accepts PDF, DOCX, TXT, Markdown, HTML and common scan images up to 50 MB."}

对于短来源和同步客户端，请使用同步 API.

联系我们