此 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：清理文件元数据

提交一个不超过 50 MiB 的图像、PDF、音频或视频文件。原文件绝不会被修改。服务会从副本中移除 ExifTool 识别的常见元数据，并在支持时保留方向和颜色配置标签。这不保证完全匿名化。

端点: POST https://mxprocess.com/api/files/start-process
身份验证: Bearer JWT
费用: 3 tokens, 成功后收取。

开始清理

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --form 'actionName=MetadataCleaner' \ --form 'file=@/path/to/file.jpg' \ --form 'parameters=[]' \ --form 'async=true'

保存返回的 id 并轮询 /api/actions/get-action-infos/{id} ，使用相同的 JWT。当 accomplished 为 true, actionResults 包含清理后的文件 (cleaned-<original>) 以及文件 <original>.metadata-report.json. 请通过各自的认证 URL 下载每个结果。

初始响应

{"id":123,"action":{"actionName":"MetadataCleaner","slug":"clean-file-metadata-online"},"accomplished":false,"actionResults":[],"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

完成报告

{ "fileName": "photo.jpg", "sizeBytesBefore": 24576, "sizeBytesAfter": 23100, "sha256Before": "...", "sha256After": "...", "metadataFoundBefore": true, "metadataKeysBefore": ["Make", "GPSLatitude", "GPSLongitude"], "metadataKeysAfter": [], "removedFields": ["GPSLatitude", "GPSLongitude", "Make"], "preservedFields": [], "generatedAt": "2026-09-12T12:00:00+00:00" }

如果文件没有可写元数据（例如纯文本），则副本会原样返回，并且 metadataFoundBefore 为 false. 无效的文件数量、无法访问的文件或超过 50 MiB 的文件会在处理前被拒绝。

联系我们


API 会发送 JSON 响应确认流程已启动。请记下“trackingUrl”字段，以便跟踪已启动的流程。响应中还包含流程 ID；本例中的 ID 为 643： { "id": 643, "actionParameters": [], "dateOfDemand": "2024-01-28T11:03:25+01:00", "hostedFileIds": [ { "fileId": 608, "parameters": "" } ], "action": { "actionName": "MetadataCleaner", "slug": "clean-file-metadata-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": "MetadataCleaner", "slug": "clean-file-metadata-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": "MetadataCleaner", "slug": "clean-file-metadata-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 : MetadataCleaner