توثيق API, MeetingBrief

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

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

حمّل تسجيلاً واحداً لاجتماع واستلم في استجابة HTTP نفسها تفريغاً نصياً وموجزاً تنفيذياً وسجل إجراءات ومسودة بريد للمتابعة.

نقطة النهاية: POST https://mxprocess.com/api/files/start-process
المصادقة: Bearer JWT المُستخرج من POST /api/login_check
التكلفة: 480 tokens لكل تنفيذ ناجح.

الطلب

يجب أن يكون الطلب بصيغة 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=false'

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

استخدم الوضع المتزامن فقط عندما يستطيع عميل HTTP انتظار التفريغ والتحليل. للتسجيلات الطويلة استخدم واجهة API غير متزامنة.

الاستجابة الناجحة

يحتوي الحقل output على الموجز المنظم و downloadResults. للتوافق مع نقطة النهاية المتزامنة الحالية، يُسلسل طلب الإجراء المحفوظ تحت "0" المفتاح؛ استخدم 0.id لتنزيل الملفات عبر نقطة النهاية الموثقة أدناه.

{
  "output": {
    "brief": {
      "title": "Weekly project review",
      "executive_summary": "...",
      "decisions": [{"decision": "...", "evidence": "..."}],
      "action_items": [{"task": "...", "owner": "", "due_date": "", "priority": "high", "evidence": "..."}],
      "risks": [],
      "open_questions": [],
      "follow_up_email": {"subject": "...", "body": "..."}
    },
    "downloadResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  },
  "0": {
    "id": 123,
    "accomplished": true,
    "actionResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  }
}

تنزيل مخرج

استبدل ACTION_ID بمعرّف طلب الإجراء المُعاد واستخدم اسم الملف الدقيق من downloadResults.

curl --location --request GET 'https://mxprocess.com/api/actions/download-action-result/ACTION_ID/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."
}

اتصل بنا