توثيق API, أنشئ فيديوهات رائجة وانشرها على قناة YouTube مخولة.

API : أنشئ فيديوهات رائجة وانشرها على قناة YouTube مخولة.

هذا 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.

استخدم الرمز لبدء العملية

معلمات الإجراء

أرسل parameters ككائن JSON. تُعلّم الحقول المطلوبة بـ مطلوب.

country — string; مطلوب; الحد الأقصى 2 حرفاً.
periodHours — enum:24,48,72; مطلوب.
maxVideos — integer; مطلوب; الحد الأدنى 1; الحد الأقصى 4.
excludeSport — boolean.
language — string; الحد الأقصى 80 حرفاً.
imageSource — enum:ai,wikimedia_commons.
maxScriptDuration — integer; الحد الأدنى 15; الحد الأقصى 60.
privacyStatus — enum:private,unlisted,public.
imageInstructions — string; الحد الأقصى 500 حرفاً.
facebookPageId — string; الحد الأقصى 128 حرفاً.
facebookPublishMode — enum:video,youtube_link,text_only,double.
voiceName — string; الحد الأقصى 120 حرفاً.
categoryId — enum:1,2,10,15,17,19,20,22,23,24,25,26,27,28.
watermarkText — string; الحد الأقصى 80 حرفاً.
hideHumanFaces — boolean.
specificTopic — string; الحد الأقصى 200 حرفاً.
source — enum:google_trends,children_story,specific_topic.
specificTopicCategory — enum:automobile,nutrition,fitness,weight_loss_women,personal_finance,youtube,tiktok,entrepreneurship,technology,artificial_intelligence,home_garden,cooking,travel,beauty,fashion,parenting,pets,relationships,career,education,language_learning,history,science,nature,entertainment,gaming,crime,asmr.
chooseRandomTopic — boolean.
youtubeConnectionId — integer.
tiktokConnectionIds — integer; الحد الأدنى 1.

curl --location 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/FILE_PATH/FILE_NAME"' \
--form 'actionName="AutomatedShortsPublisher"' \
--form 'parameters={"country":"US","periodHours":"24","maxVideos":1,"excludeSport":false,"language":"English","imageSource":"ai","maxScriptDuration":15,"privacyStatus":"private","imageInstructions":"example","facebookPageId":"example","facebookPublishMode":"video","voiceName":"example","categoryId":"1","watermarkText":"example","hideHumanFaces":false,"specificTopic":"example","source":"google_trends","specificTopicCategory":"automobile","chooseRandomTopic":false,"youtubeConnectionId":1,"tiktokConnectionIds":1}' \
--form 'async="false"' \
--form 'fileUrl=""' \
--form 'fileContent=""'

إذا كان ملفك متاحاً عبر URL، يمكنك تجاهل الحقل « file=@.. » واستخدام عنوان الملف مباشرة في حقل « fileUrl ».

يرسل 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": "AutomatedShortsPublisher",
        "slug": "automated-shorts-publisher",
        "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 للمطورين : AutomatedShortsPublisher