واجهة API غير متزامنة: موجز الاجتماعات بالذكاء الاصطناعي

يلزم وجود حساب مجاني قبل استخدام واجهة API هذه. أنشئ حسابك وثبّته على /ar/create-account, ثم احصل على JWT باستخدام بيانات اعتمادك.

استخدم هذا الوضع لتسجيلات الاجتماعات مهما كانت مدتها. تنشئ واجهة API الإجراء فوراً، ثم ينتج العامل التفريغ النصي وتقرير Markdown وJSON منظماً في الخلفية.

نقطة النهاية: POST https://mxprocess.com/api/files/start-process
المصادقة: Bearer JWT من POST /api/login_check
التكلفة: 480 tokens, تُحصّل الرموز بعد نجاح المعالجة فقط.

1. بدء الإجراء

أرسل ملفاً صوتياً أو مرئياً بصيغة multipart/form-data. يجب أن تكون قيمة parameters سلسلة JSON.

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --header 'Accept: application/json' \ --form 'file=@"/absolute/path/weekly-review.mp4"' \ --form 'actionName=MeetingBrief' \ --form 'parameters=[["language",["French"]],["audience",["project team"]],["focus",["decisions, actions, risks and open questions"]]]' \ --form 'async=true'

مقبول: MP3 وWAV وM4A وAAC وOGG وFLAC وWebM وMP4 وMOV وMKV وAVI. يلزم تسجيل واحد بالضبط. القيم الافتراضية للمعلمات الاختيارية هي الفرنسية وفريق المشروع والقرارات/الإجراءات/المخاطر/الأسئلة المفتوحة.

2. الاستجابة الأولية

احتفظ بـ id أو trackingUrl; لم يوضع التسجيل في هذه المرحلة إلا في قائمة الانتظار.

{ "id": 123, "actionParameters": [["language", ["French"]]], "hostedFileIds": [{"fileId": 456, "parameters": ""}], "action": {"actionName": "MeetingBrief", "slug": "ai-meeting-brief"}, "accomplished": false, "actionResults": [], "priceInTokensAtTimeOfUse": 18, "trackingUrl": "https://mxprocess.com/api/actions/get-action-infos/123" }

3. استطلع الحالة

استعلم كل 10–15 ثانية حتى تصبح قيمة accomplished هي true. لا تعِد إرسال التسجيل الأصلي أثناء المعالجة.

curl --location --request GET 'https://mxprocess.com/api/actions/get-action-infos/123' \ --header 'Authorization: Bearer YOUR_TOKEN' { "id": 123, "accomplished": true, "actionResults": [ ["weekly-review-transcript.txt", "https://..."], ["weekly-review-meeting-brief.md", "https://..."], ["weekly-review-meeting-brief.json", "https://..."] ], "priceInTokensAtTimeOfUse": 18 }

4. تنزيل نتيجة

استخدم اسم الملف الدقيق من actionResults. تعمل نقطة النهاية الموثقة سواء كان تخزين الكائنات مفعلاً أم لا.

curl --location --request GET 'https://mxprocess.com/api/actions/download-action-result/123/weekly-review-meeting-brief.json' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --output weekly-review-meeting-brief.json

مثال على خطأ وظيفي

{ "error": "ERROR_MB004 MeetingBrief accepts audio or video recordings only." }

هل تحتاج إلى استجابة فورية؟ استخدم واجهة API متزامنة للتسجيلات القصيرة.

اتصل بنا