此 API 易于使用。只需按照以下步骤操作

• 免费创建账户
• 点击通过电子邮件收到的链接以确认您的地址。
• 使用凭据生成令牌

您可以使用任何语言进行此 CURL 调用。 (Python, PHP, Java, JavaScript...) 需要帮助？

curl --location --request POST 'https://mxprocess.com/api/login_check' \ --header 'Content-Type: application/json' \ --data-raw '{"username":"YOUR_LOGIN","password":"YOUR_PASSWORD"}'

如果凭据正确，我们的服务器会在响应中提供令牌： {"token": "YOUR_TOKEN","refresh_token": "YOUR_REFRESH_TOKEN"}
YOUR_TOKEN 的有效期为一小时；可以使用 YOUR_REFRESH_TOKEN 延长有效期。


• 使用令牌异步启动流程
正在下载结果： 当 API 响应中包含 actionResultsDownloadURLs 时，其中包含用于下载每个生成结果文件的已认证 URL。



异步 API：视频拼接

将 2 到 15 个视频作为 file0 至 file14 发送，或在 fileUrl 中发送以 | 分隔的公开视频 URL。上传文件和 URL 可以混用。每个输入最多 100 MB、10 分钟；全部输入合计最多 1 GB、30 分钟。

端点: POST https://mxprocess.com/api/files/start-process
身份验证: Bearer JWT
费用: 15 令牌，仅在成功后扣除。

上传文件

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'file0=@/path/to/first.mp4' \ --form 'file1=@/path/to/second.mov' \ --form 'parameters=[]' \ --form 'async=true'

公开视频 URL

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=VideoConcat' \ --form 'fileUrl=https://example.com/first.mp4|https://example.com/second.webm' \ --form 'parameters=[]' \ --form 'async=true'

保存返回的操作 ID，并使用相同 JWT 轮询 /api/actions/get-action-infos/{id}。完成后，actionResults 包含一个名为 video-concat.mp4 的经过身份验证的可下载文件。

初始响应

{"id":123,"action":{"actionName":"VideoConcat","slug":"concat-video-online"},"accomplished":false,"actionResults":[],"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

基数、所有权、MIME/内容、大小和时长会在处理前校验；不符合时返回稳定的 VIDEO_CONCAT_* 错误。

联系我们


API 会发送 JSON 响应确认流程已启动。请记下“trackingUrl”字段，以便跟踪已启动的流程。响应中还包含流程 ID；本例中的 ID 为 643： { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/643" }


• 要跟踪进度，请执行简单的 GET 请求（可以每 10 秒调用一次）：
curl --location 'https://mxprocess.com/api/actions/get-action-infos/643' \ --header 'Authorization: Bearer YOUR_TOKEN' }}

如果流程尚未完成，您将收到带有以下内容的响应 "accomplished": false { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": null, "endTime": null, "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": false, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

如果流程已完成，您将收到带有以下内容的响应 "accomplished": true. actionResultsDownloadURLs 字段包含用于下载生成结果的经过身份验证的 URL： { "actionResultsDownloadURLs": [ "https://mxprocess.com/api/actions/download-result/643/35084b44a841ec597be3048df44145e8.txt.log/YOUR_TOKEN" ], "id": 643, "actionParameters": { "commandParameters": "" }, "dateOfDemand": "2024-01-28T11:03:25+01:00", "startTime": "2024-01-28T11:24:49+01:00", "endTime": "2024-01-28T11:25:09+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "VideoConcat", "slug": "concat-video-online", "jsonRequestSample": null, "jsonResponseSample": null, "specificDeveloperRequestDocumentation": null, "specificDeveloperResponseDocumentation": null, "longDescription": null }, "user": [], "accomplished": true, "userIsNotifiedByEmail": "off", "userIsNotifiedByPostQuery": "off", "actionResults": [ [ "35084b44a841ec597be3048df44145e8.txt.log" ] ], "priceInTokensAtTimeOfUse": 3, "retryCount": 0, "executionPlannedAt": null, "trackingUrl": "" }

直接使用 actionResultsDownloadURLs 中提供的每个 URL 下载对应结果。

这份文档是否不清晰？ (Python, PHP, Java, JavaScript...) 需要帮助？

联系我们 此 API 也提供同步模式： 开发者 API : VideoConcat