توثيق API, دمج من مقطعين إلى 15 مقطع فيديو في ملف MP4 واحد.

API : دمج من مقطعين إلى 15 مقطع فيديو في ملف MP4 واحد.

هذا 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, VideoConcat

جارٍ تنزيل النتائج: عند وروده في استجابة API، actionResultsDownloadURLs يحتوي على عناوين URL موثّقة لتنزيل كل ملف نتيجة تم إنشاؤه.

واجهة API غير متزامنة: دمج الفيديوهات

أرسل من مقطعي فيديو إلى 15 مقطعاً في file0 حتى file14، أو أرسل عناوين URL عامة مفصولة بالرمز | في fileUrl. يمكن الجمع بين الرفع وعناوين URL. يقتصر كل إدخال على 100 ميغابايت و10 دقائق؛ ويقتصر مجموع الإدخالات على 1 غيغابايت و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'

احتفظ بمعرّف الإجراء المُعاد واستعلم عن /api/actions/get-action-infos/{id} باستخدام JWT نفسه. عند الاكتمال، يحتوي 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 لتأكيد انتهاء العملية. نزّل الملفات المُنشأة باستخدام عناوين URL الموثقة في actionResultsDownloadURLs.


{
    "actionResultsDownloadURLs": [
        "https://mxprocess.com/api/actions/download-result/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3/YOUR_TOKEN"
    ],
    "id": 1016,
    "actionParameters": [],
    "dateOfDemand": "2024-02-07T20:51:42+00:00",
    "startTime": "2024-02-07T20:51:46+01:00",
    "endTime": "2024-02-07T20:51:46+01:00",
    "hostedFileIds": [
        {
            "fileId": 1025,
            "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": [
        [
            "a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3",
            "https://mxprocessfiles.s3.eu-west-1.amazonaws.com/AudioToGPT/1016/a62be5bf2ad15dc82940bcddbe3f000c.mp3.mp3"
        ]
    ],
    "priceInTokensAtTimeOfUse": 15,
    "retryCount": 0,
    "executionPlannedAt": null,
    "trackingUrl": ""
}

هل هذا التوثيق غير واضح؟ (Python, PHP, Java, JavaScript...) هل تحتاج إلى مساعدة؟

اتصل بنا يتوفر هذا API أيضاً في الوضع غير المتزامن: API للمطورين : VideoConcat