ClipReel للوكلاء

أتمتة تحرير الفيديو باستخدام الوكلاء الأذكياء

استخدم REST API الخاص بـ ClipReel لأتمتة عروض المنتجات، ومقاطع وسائل التواصل الاجتماعي، والتعليقات، والتعديلات القابلة للمراجعة مع مهام تقديم دائمة.

توصيل وكيل

جرّب التحرير على لقطات حقيقية

قارن بين اللقطة الأصلية ذات الثماني ثوانٍ والنسخة المعدلة ذات الست ثوانٍ. افتح المشروع النموذجي مع جاهزية الطلب للإرسال.

قص الثواني الأولى، وأضف العنوان "يوم على الحافة" لمدة ثلاث ثوانٍ، واجعل تدرج الألوان أكثر برودة، وأضف تأثير تلاشٍ في النصف ثانية الأخيرة.
جرّب في ClipReel تنزيل المقطع المصدري
اللقطة الأصلية
قص، وعنونة، وتلاشٍ

اتصل بـ ClipReel

أنشئ رمزاً محدداً النطاق، واحفظه كـ CLIPREEL_API_TOKEN، وقم بتهيئة العميل الخاص بك. استخدم رمز قراءة المشروع، وكتابة المشروع، ورمز المهمة لإجراء الجولة الإرشادية.

curl https://www.clipreel.com/api/v1/projects \
  -H "Authorization: Bearer $CLIPREEL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Product walkthrough"}'

أتمتة عرض توضيحي للمنتج على مراحل

أنشئ مشروعاً لكل إصدار واستورد تسجيلات الشاشة الأصلية. أدرج edit_by_prompt مع مقدمة واضحة، ومدة مستهدفة، ومتطلبات التسميات التوضيحية. أرسل مفتاح تكرار (idempotency key) لكل مهمة لتتمكن من استعادة النتيجة الأصلية في حال إعادة المحاولة.

بناء نسخ مخصصة لوسائل التواصل الاجتماعي من النسخة المعتمدة

ثبّت نفس المراجعة المحفوظة في كل طلب export_video وأرسل مفتاحاً متميزاً لنسب العرض 16:9 أو 9:16 أو المربع. استعلم عن مورد المهمة لمعرفة الحالة التالية. استخدم رابط التحرير لفتح نفس اللقطات، والقصاصات، والتسميات التوضيحية، والتأثيرات قبل طلب تصدير آخر.

معالجة الأخطاء والأذونات في تكاملك

استخدم رموز الحساب المقيدة وقم بالرفع مباشرة إلى الرابط الموقّع. تحقق من توقيعات رد الاتصال مقابل نص الطلب الخام قبل قراءة اكتمال المهمة. استخدم معرف المهمة الثابت لمعالجة عمليات إعادة المحاولة. بالنسبة لتطبيق شريك، أنشئ جلسة تضمين مقيدة واحدة لنطاقها ومشروعها المحددين.

سير عمل REST

أرسل JSON مع Authorization: Bearer $CLIPREEL_API_TOKEN. لاستيراد ملف، أرسل اسم الملف المعلن، ونوع الوسائط، وطول البايت، والمدة إلى POST /tools/import_media. ارفع الملف بنفس نوع المحتوى والطول إلى الرابط المرجوع.

مسودة نسخة الإطلاق

POST https://www.clipreel.com/api/v1/tools/edit_by_prompt
{
  "projectId": "PROJECT_ID",
  "prompt": "Remove pauses, add captions, and cut a 45-second launch video",
  "idempotencyKey": "launch-v1-edit"
}

إنشاء أو استيراد مؤشرات التسميات التوضيحية

أدرج POST /tools/transcribe_video مع معرف المشروع. ثم استعلم عن GET /jobs/JOB_ID. مرر النتيجة المرجعة result.cues to POST /tools/add_captions مع نمط مثل white or lime. استخدم نفس كائن المؤشر للطوابع الزمنية التي توفرها بنفسك.

تصدير نسخة عمودية

POST https://www.clipreel.com/api/v1/tools/export_video
{
  "projectId": "PROJECT_ID", "revision": 7,
  "aspect": "9:16", "resolution": "720p",
  "idempotencyKey": "launch-v1-vertical", "webhookId": "WEBHOOK_ID"
}

التحقق من ردود الاتصال الموقعة

سجّل نقطة نهاية HTTPS الخاصة بك في POST /webhooks مع {"url":"https://partner.example.com/clipreel"}. احفظ سر التوقيع المرجوع. احسب HMAC-SHA256 عبر طابع Unix الزمني، وفترة زمنية، ونص الطلب الخام. قارن في وقت ثابت مع v1 في ClipReel-Signature الترويسة. ارفض الطوابع الزمنية التي يتجاوز عمرها خمس دقائق. تعامل مع ClipReel-Delivery باعتباره معرف إلغاء التكرار. استعلم عن روابط وسائط موقعة جديدة.

تضمين نفس المشروع القابل للتحرير

POST https://www.clipreel.com/api/v1/embed-sessions
{
  "projectId": "PROJECT_ID",
  "origin": "https://partner.example.com",
  "permission": "edit"
}

حمّل embedUrl في إطار iframe على النطاق المسجل. تستمر الجلسات لمدة 20 دقيقة وترث أذونات الرمز. اضبط permission to view لجلسة مخصصة للمراجعة فقط. يفتح خيار الفتح في ClipReel المحرر ويعيده إلى المشروع الخاص في مساحة العمل الكاملة.

إعداد العميل وسير العمل

تحرير الفيديو في Claude Code

اطلب من Claude Code تحويل التسجيلات إلى مقطع قابل للتحرير. راجع المعاينة، ثم افتح المشروع نفسه في ClipReel.

إعداد Claude Code
قص أول ثانيتين

خادم MCP لتحرير الفيديو

قم بتوصيل عميل MCP بـ ClipReel لإنشاء مشاريع، واقتراح تعديلات على الجدول الزمني، ومراجعة المعاينات، وتصدير مقاطع قابلة للتحرير.

إعداد MCP

تحرير فيديوهات المنتج من Cursor

استخدم Cursor وClipReel لتحويل تسجيلات شرح المنتج إلى فيديو قابل للتحرير مع تعليقات وتنسيقات تصدير متعددة.

سير عمل Cursor

أتمتة تحرير الفيديو باستخدام الوكلاء الأذكياء

استخدم REST API الخاص بـ ClipReel لأتمتة عروض المنتجات، ومقاطع وسائل التواصل الاجتماعي، والتعليقات، والتعديلات القابلة للمراجعة مع مهام تقديم دائمة.

دليل REST API

تستخدم المهام المستضافة خطة ClipReel الخاصة بك. اطّلع على تعديلات الدردشة ورصيد الفيديو حسب الخطة.