الأتمتة

أنشئ الفيديوهات واربط النتائج المكتملة بسير عملك من خلال اشتراكات إكمال Reela CLI.

يوفر Reela أوامر لإنتاج الفيديوهات واشتراكات إكمال للفيديوهات المكتملة. يمكن لوكيل أو أداة أخرى إرسال موجز وتلقي النتيجة عبر البرنامج الخفي لـ CLI من دون إبقاء موقع Reela مفتوحًا.

من الموجز إلى الفيديونسخ رابط العنوان

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

reela create --prompt-file brief.txt \
  --visual ai-video --layout portrait --duration 30 \
  --session "Product campaign" --output json

إنشاء الفيديو مهمة طويلة الأمد. ابدأ البرنامج الخفي واضبط اشتراك إكمال قبل الإرسال؛ إذ ينفّذ Reela عملية الإنشاء في الخلفية ويسلّم النتيجة المكتملة إلى البرنامج النصي. يؤدي استخدام عنوان جلسة مرة أخرى إلى تجميع الفيديوهات ذات الصلة في مشروع. راجع التسليم التلقائي أدناه للإعداد.

قبل الإرسال، أضف --dry-run للتحقق من صحة الطلب ومعاينة الرصيد المقدّر من دون رفع الملفات أو إنشاء مهمة. قد يؤدي إرسال مهمة إلى استهلاك الرصيد.

راجع خيارات إنشاء الفيديو للاطلاع على العناصر المرئية ووسائط الإدخال المدعومة.

اختر الجودة والتكلفة باستخدام المستوياتنسخ رابط العنوان

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

reela tiers list
reela tiers list --output json

تعرض القائمة تسمية كل مستوى ووصفه وتحدد المستوى الافتراضي. في مخرجات JSON، يحتوي tiers على إدخالات تتضمن label وcontent وis_default؛ ويحدد default_tier المستوى الافتراضي. اقرأ content لفهم كل خيار بدلًا من الاختيار حسب موضعه في القائمة. لا يضمن عرض المستويات إمكانية استخدام حسابك لكل الخيارات؛ إذ يتحقق Reela من صلاحية الوصول عند التحقق من الطلب أو إرساله.

مرّر التسمية المطابقة تمامًا إلى --tier. استبدل <tier-label> أدناه بتسمية من قائمتك، مع الإبقاء على علامتي الاقتباس إذا احتوت على مسافات:

reela create --prompt-file brief.txt --visual ai-video \
  --tier "<tier-label>" --duration 30 --layout portrait \
  --dry-run --output json

تعرض المعاينة credits_cost وquota_after. للإرسال، أزل --dry-run وأبقِ المستوى المحدد والخيارات الأخرى. يصف المستوى خيارًا للإنشاء؛ استخدم المعاينة لتقدير تكلفة طلبك الفعلي.

إذا حذفت --tier، فسيستخدم Reela القيمة الافتراضية الحالية المتاحة لـ CLI. إذا لم تتوفر قيمة افتراضية، شغّل reela tiers list لتحديث الخيارات أو حدّد مستوى صراحةً. يضمن تحديد مستوى صراحةً استقلال خيار سير عملك عن تغييرات القيمة الافتراضية؛ لكن قد تظل إمكانية التوفر والأسعار قابلة للتغيير. استخدم الملف التعريفي نفسه عند عرض المستويات ومعاينتها وإرسالها.

راجع مرجع أمر المستويات للاطلاع على تفاصيل المخرجات وسلوك الاختيار.

نتائج منظّمة للوكلاء والأدواتنسخ رابط العنوان

يتيح --output json الحصول على نتائج الأوامر، بما فيها خيارات المستويات وتقديرات الرصيد وتأكيدات الإرسال، على شكل بيانات منظّمة. يعني رمز الخروج 0 نجاح الأمر؛ أما الأخطاء فتستخدم رموز خروج غير صفرية ونصًا عاديًا على stderr، بما في ذلك في وضع JSON.

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

التسليم التلقائينسخ رابط العنوان

يمكن لـ Reela CLI تشغيل ملف تنفيذي خاص بك عند اكتمال مهمة فيديو. يربط اشتراك الإكمال هذا مخرجات Reela بإجراءك التالي: تسليم فيديو إلى أداة نشر، أو تحديث سجل، أو إخطار نظام آخر. يراقب Reela اكتمال المهمة ويزوّد البرنامج النصي بتفاصيلها.

تسجيل البرنامج النصينسخ رابط العنوان

قدّم مسارًا مطلقًا إلى ملف تنفيذي على الجهاز الذي يشغّل Reela CLI. يمكن أن يكون مكتوبًا بأي لغة، شرط أن يقرأ الحدث من stdin ويبلّغ عن النجاح من خلال رمز الخروج الخاص به.

reela subscribe add script --path /absolute/path/on-video \
  --timeout-seconds 300 --max-retries 3

لكل ملف تعريفي اشتراك برنامج نصي واحد. لتغيير الملف التنفيذي لاشتراك موجود، استخدم reela config set delivery.script.path /absolute/path/on-video. أعد تشغيل برنامج خفي قيد التشغيل بالفعل بعد تغيير الاشتراك أو إعداداته، كما هو موضح أدناه.

استلام حدث الإكمالنسخ رابط العنوان

يشغّل Reela الملف التنفيذي ويكتب كائن JSON واحدًا إلى stdin:

{
  "event": "task.completed",
  "task_id": "12345",
  "status": "completed",
  "status_label": "completed",
  "title": "Product demo",
  "description": "A short product introduction",
  "download": {
    "filename": "product-demo.mp4",
    "download_url": "https://example.com/video.mp4"
  }
}

استخدم task_id لربط الحدث بإرسالك الأصلي. قد تكون title وdescription وdownload من null. وعند توفره، يزوّد download برنامجك النصي باسم الملف المقترح للفيديو المكتمل ورابط التنزيل كي يستخدمهما مباشرة. عالج حالة غياب قيمة download قبل تشغيل إجراء يتطلب الفيديو.

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

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

التنفيذ وإعادة المحاولةنسخ رابط العنوان

• النجاح: أعد 0 بعد نجاح الإجراء. يهمل Reela مخرجات stdout للبرنامج النصي؛ ولا يستخدم المخرجات المطبوعة بوصفها النتيجة.
• المهلة: تتيح --timeout-seconds 300 مدة تصل إلى 300 ثانية لكل استدعاء. يؤدي تجاوز المهلة أو الخروج برمز غير صفري إلى فشل التسليم.
• إعادة المحاولة: يعيد Reela محاولة التسليم الفاشل. عندما يفشل أسلوب البرنامج النصي وحده، تتيح --max-retries 3 ثلاث محاولات إجمالًا، بما فيها المحاولة الأولى. وتستخدم الإخفاقات التي تشمل أساليب أخرى مفعّلة delivery.max_retries.
• تكرار التسليم: اجعل الإجراءات آمنة عند تكرارها للحدث نفسه task_id، كي لا يؤدي استدعاء آخر إلى نشر الفيديو نفسه أو إضافة السجل نفسه مرتين.

إبقاء الاشتراك قيد التشغيلنسخ رابط العنوان

يتولى البرنامج الخفي لـ CLI معالجة أحداث الإكمال وتشغيل أساليب التسليم المفعّلة. بعد اختيار أساليبك، ابدأ تشغيله وتحقق من حالة التسليم:

reela daemon start
reela subscribe status

تحاول إضافة أسلوب أيضًا بدء تشغيل برنامج خفي متوقف. إذا كان قيد التشغيل بالفعل، فأعد تشغيله بعد تغيير إعدادات التسليم لكي تسري تلك الإعدادات. بالنسبة إلى برنامج خفي بدأ تشغيله يدويًا، استخدم reela daemon stop ثم reela daemon start.

يحفظ Reela تقدم التسليم ويستأنف منه عند إعادة تشغيل البرنامج الخفي. في غياب تقدم محفوظ، يتابع الأحداث الجديدة افتراضيًا. كما يعالج reela daemon start --keep-backlog أحداث المهام المكتملة السابقة التي لا تزال متاحة عند عدم وجود تقدم محفوظ.

استخدم reela daemon install لتمكين التشغيل عند تسجيل الدخول. إذا ثُبّت كخدمة، فأعد تشغيله عبر مدير الخدمات في نظام التشغيل بعد إجراء تغييرات الإعداد. تحقّق من reela daemon status أو reela daemon logs --tail 50 لمراجعة التسليم.

يتطلب التسليم التلقائي أن يبقى الجهاز الذي يشغّل البرنامج الخفي مستيقظًا ومتصلًا. ابدأ تشغيله قبل إرسال الفيديوهات التي ينبغي أن يؤدي اكتمالها إلى تشغيل برنامجك النصي.

يتوفر daemon وsubscribe على Linux وmacOS. ويدعم Windows x64 أوامر الفيديو واستعلامات الحالة والتنزيلات اليدوية.

تنزيل وتسليم عبر البريد الإلكتروني اختيارياننسخ رابط العنوان

يمكنك تفعيل التنزيلات التلقائية أو رسائل البريد الإلكتروني بالفيديوهات المكتملة إلى جانب برنامجك النصي. تكون التنزيلات مفعّلة في إعدادات التسليم الافتراضية؛ حدّد الوجهة باستخدام reela config set delivery.download ~/Videos/reela. وإذا كانت معطّلة، ففعّلها باستخدام reela subscribe add download --dir ~/Videos/reela. فعّل البريد الإلكتروني باستخدام reela subscribe add email، ويمكنك إضافة --address me@example.com اختياريًا لاستخدام عنوان غير عنوان البريد الإلكتروني لحسابك.

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

أعد استخدام إعدادات الإنتاج لديكنسخ رابط العنوان

يوفر Reela إمكانات إضافية يمكن أن تصبح خطوات في سير عملك:

• اتساق العلامة التجارية: اعرض حزم العلامة التجارية الموجودة باستخدام brand list وطبّق إحداها على مهمة باستخدام brand apply. ينتظر الأمر المخرجات التي تحمل العلامة التجارية. راجع أوامر العلامة التجارية.
• التحرير البرمجي: نزّل JSON التحرير، وتحقق من صحة التغييرات، واحفظ مسودة لمعاينتها، وأرسل عملية تصيير باستخدام edit. راجع أوامر التحرير.
• حسابات وتفضيلات منفصلة: حدّد ملفًا تعريفيًا باستخدام --profile أو REELA_PROFILE. تنطبق أساليب التسليم وإعداداته على الملف التعريفي المحدد. راجع الملفات التعريفية والإعدادات.

على سبيل المثال، يمكن لسير عمل فيديو منتج إرسال موجز مع صور مرجعية واستخدام اشتراك إكمال للبرنامج الخفي لتسليم الفيديو المكتمل إلى أداة النشر الخاصة بك. يوفر Reela الإنشاء في الخلفية وتسليم الإكمال؛ أما أداتك فتختار موعد الإرسال والإجراء الذي ستتخذه عند وصول النتيجة.

راجع مرجع أمر التسليم للاطلاع على جميع خيارات الاشتراك والبرنامج الخفي. للتثبيت وتفويض الحساب، ابدأ بـ البدء.