مرجع الأوامر

صياغة أوامر Reela ووسائطها وخياراتها. شغّل reela <command> -h للحصول على المساعدة في الإصدار المثبّت لديك.

login / logout / whoami / statusنسخ رابط العنوان

reela login
reela logout
reela whoami
reela status

• login يسجّل الدخول من خلال تفويض المتصفح. افتح عنوان URL المعروض، وأدخل الرمز إذا طُلب منك ذلك، وانتظر حتى ينتهي الأمر.
• logout يسجّل الخروج من الملف الشخصي المحدد.
• whoami يعرض الحساب الذي سجّلت الدخول إليه.
• status يتحقق من حالة الحساب والتسليم.

reela --profile work login
reela --profile work whoami

createنسخ رابط العنوان

أنشئ فيديو من مطالبة وملفات وسائط اختيارية.

reela create [PROMPT] --visual <TYPE> [OPTIONS]

قدّم مطالبة موضعية أو --prompt-file. يلزم تقديم --visual واحد على الأقل.

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

• ai-video: أنشئ لقطات؛ ويمكن إرفاق reference-image:<path> لتحديد النمط.
• avatar: أدرج مقدّماً يتم اختياره باستخدام --avatar <id>.
• original-clip: حرّر لقطات الفيديو من دون صوتها؛ أرفق video-source:<path>.
• original-sync: احتفظ بصوت لقطات الفيديو؛ أرفق video-audio:<path>.
• image-video: حرّك صورة؛ أرفق original-image:<path>.

استخدم background-music:<path> لموسيقاك الخاصة. كرّر الخيارات بدلاً من جمع القيم مفصولة بفواصل.

أمثلةنسخ رابط العنوان

reela create "A product demo" --visual ai-video --layout portrait --dry-run
reela create --prompt-file brief.txt --visual image-video --file original-image:photo.png --dry-run

راجع تقدير الرصيد أولاً. شغّل البرنامج الخفي واضبط اشتراك التسليم قبل إزالة --dry-run لإرسال الطلب. قد يستهلك الإرسال رصيداً؛ وتنشئ Reela الفيديو في الخلفية وتسلّم النتيجة النهائية عبر اشتراكك. راجع قسم البرنامج الخفي / الاشتراك أدناه.

tasksنسخ رابط العنوان

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

reela tasks list [--status <STATUS>] [--limit <N>] [--offset <N>] [--sort <ORDER>]
reela tasks get <TASK_ID>
reela tasks versions <TASK_ID> --origin brand [--limit <N>] [--offset <N>]
reela tasks download <TASK_ID> [--video <ID>] [--out-dir <DIR>]

• list: يعرض 20 نتيجة افتراضياً، مع إزاحة 0، مرتبة حسب created_at:desc. عوامل تصفية الحالة: cancelled، pending، processing، failed، partial، completed.
• get: اعرض حالة المهمة وتقدمها ومطالبة الإنشاء متى توفرت.
• versions: اعرض إصدارات مخرجات Brand، بما فيها المخرجات غير المكتملة. يتطلب --origin brand. الحد: من 1 إلى 100 (الافتراضي 20)؛ والإزاحة الافتراضية 0.
• download: نزّل الفيديو المكتمل إلى الدليل المضبوط أو --out-dir (الصيغة المختصرة: -o). استخدم --video لاختيار مخرج Brand مكتمل.

reela tasks list --status completed --output json

collectionنسخ رابط العنوان

اعرض مقاطع الفيديو في مجموعة موجودة، بما في ذلك العناوين والأوصاف.

reela collection list [--session <TITLE>]
reela collection list --session "Product launch" --output json

تكون الأولوية لـ REELA_COLLECTION_ID عند ضبطه. وإلا، يبحث الأمر عن الجلسة في الملف الشخصي المحدد. الجلسة الافتراضية هي reela-YYYY-MM-DD باستخدام التاريخ المحلي، وليست آخر جلسة مستخدمة. لا ينشئ هذا الأمر مجموعة؛ استخدم create لبدء واحدة.

قد تتضمن مقاطع الفيديو المكتملة عناوين URL للتنزيل. تعامل مع هذه الروابط على أنها حساسة ولا تنشرها؛ ولا تفترض أن كل رابط يتطلب مصادقة أو أن مدة صلاحيته واحدة.

avatarنسخ رابط العنوان

reela avatar list
reela avatar get <ID>

يسرد avatar list الشخصيات الافتراضية المتاحة؛ ويعرض avatar get تفاصيل إحدى الشخصيات الافتراضية. استخدم معرّفها مع create --avatar.

tiersنسخ رابط العنوان

اعرض خيارات الإنشاء والفئة الافتراضية للملف الشخصي المحدد.

reela tiers list
reela tiers list --output json
reela --profile work tiers list

يعرض النص العادي التسمية المعروضة لكل فئة ووصفها وعلامة الفئة الافتراضية. يتضمن إخراج JSON ما يلي:

• default_tier: تسمية الفئة الافتراضية، عند توفرها.
• tiers: قائمة الخيارات، مع label وcontent (الوصف) وis_default لكل إدخال.

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

reela create "A product demo" --visual ai-video \
  --tier "<tier-label>" --dry-run --output json

استبدل <tier-label> بتسمية يعرضها tiers list. يعرض الاستعراض المسبق credits_cost وquota_after من دون إنشاء مهمة. أزل --dry-run لإرسال الطلب بالخيارات نفسها.

من دون --tier، يستخدم create الإعداد الافتراضي المتاح لـ CLI. إذا لم يتوفر إعداد افتراضي، حدّث باستخدام tiers list أو قدّم --tier. حدّد الملف الشخصي نفسه عند عرض الفئات وإنشاء الفيديو.

brandنسخ رابط العنوان

اعرض حزم العلامة التجارية الموجودة وطبّقها.

reela brand list [--limit <N>] [--offset <N>]
reela brand apply <BRAND_ID> --task <TASK_ID> [--inputs '<JSON>']

يعرض list 20 نتيجة افتراضياً وإزاحة 0؛ ويجب أن يكون الحد من 1 إلى 100. يطبّق apply حزمة علامة تجارية وينتظر حتى 10 دقائق حتى يكتمل الفيديو.

استخدم --inputs لتقديم القيم التي تتطلبها حزمة العلامة التجارية. يقبل كائن JSON يتضمن قيماً نصية أو رقمية أو منطقية؛ ولا يدعم المصفوفات أو الكائنات المتداخلة أو القيم الخالية. تحدد الحزمة أسماء المعلمات. على سبيل المثال:

reela brand apply <BRAND_ID> --task <TASK_ID> \
  --inputs '{"AUTHOR_PROFILE_IMAGE_URL":"https://example.com/avatar.jpg","AUTHOR_NAME":"Alex"}'

تُرفض قيم القالب المطلوبة الناقصة قبل التصيير. قدّم القيم الناقصة قبل إعادة التطبيق. لا تُدرج بيانات اعتماد أو أسراراً ضمن هذه المعلمات.

إذا انقطع الانتظار، فقد تستمر العملية. تحقق من إصدارات المخرجات قبل إعادة التطبيق:

reela tasks versions <task-id> --origin brand
reela tasks download <task-id> --video <video-id>

editنسخ رابط العنوان

صدّر JSON للتحرير لمواصلة التحرير داخل Reela، أو صدّر مشروع Remotion مستقلاً للتحرير المحلي دون قيود.

reela edit versions <TASK_ID>
reela edit export-json <TASK_ID> --file <PATH> [--version <N>]
reela edit export-remotion <TASK_ID> [--video <VIDEO_ID>] [--out-dir <DIR>]
reela edit validate <FILE>
reela edit save <FILE>
reela edit render <FILE>

• versions: اعرض الإصدارات القابلة للتحرير، بما فيها المسودات وعمليات التصيير الفاشلة.
• export-json: صدّر أحدث إصدار للتحرير أو إصداراً محدداً بصيغة JSON للتحرير داخل Reela. حرّر الملف، وتحقق من صحته، ثم استخدم save أو render.
• export-remotion: صدّر مشروع Remotion مستقلاً للتحرير المحلي دون قيود. من دون --video، يصدّر الإصدار الحالي للتحرير؛ استخدم --video لاختيار إصدار فيديو. يشير --out-dir (الصيغة المختصرة: -o) إلى دليل المشروع نفسه، وليس الدليل الأب. من دونه، يُنشأ مجلد للمشروع في دليل التنزيل المضبوط. تُحفظ الوجهات الموجودة بإضافة لاحقة رقمية. يتضمن إخراج JSON الدليل النهائي path.
• validate: تحقّق من ملف JSON للتحرير بحثاً عن الأخطاء من دون رفع محتوياته. يتطلب تسجيل الدخول واتصالاً بالإنترنت.
• save: احفظ المسودة من دون تصيير. افتح عنوان URL للمعاينة الذي يظهر لمراجعتها.
• render: احفظ وانتظر حتى يكتمل التصيير. عند النجاح، لا يُعاد معرّف المهمة وعنوان URL للمعاينة إلا بعد حفظ المخرج المصيّر. تنتظر الخدمة مدة تصل إلى عشر دقائق؛ ويسمح CLI بعشر دقائق وثلاثين ثانية لتلقي الاستجابة. يؤدي فشل التصيير المؤكد إلى الخروج بالرمز 10؛ ويؤدي انتهاء المهلة إلى الخروج بالرمز 6. لا يُعاد إرسال الطلبات تلقائياً. لا يؤدي المقاطعة أو انتهاء المهلة إلى إلغاء التصيير؛ تحقّق من reela edit versions <task-id> قبل التصيير مرة أخرى.

reela edit export-json <task-id> --file edit.json
reela edit validate edit.json
reela edit save edit.json

ينتظر تصدير Remotion اكتمال تجهيز الحزمة، ثم ينزّل المشروع ويفك ضغطه، ولا يحتفظ بملف ZIP. قد يستغرق تجهيز الحزمة مدة تصل إلى عشر دقائق. لا يُعاد إرسال الطلبات تلقائياً؛ ولا يؤدي قطع الانتظار أو انتهاء مهلته إلى إلغاء تجهيز الحزمة في الخلفية. لا يمكن استيراد المشروع المُصدّر مجدداً إلى Reela، ولا يستخدم أوامر validate أو save أو render.

showنسخ رابط العنوان

نزّل مساحة عمل Show وحرّرها، وهي تتضمن show.yaml وsubjects.yaml وepisodes/*.md.

reela show list [--limit <N>] [--offset <N>]
reela show download <SHOW_ID> [--out-dir <DIR>] [--force]
reela show validate
reela show update [--dry-run] [--yes]

يعرض list 20 نتيجة افتراضياً وإزاحة 0. شغّل validate وupdate من دليل مساحة العمل التي تم تنزيلها. يعرض update --dry-run معاينة من دون الكتابة محلياً أو عن بُعد؛ أما --yes فيرسل الطلب من دون تأكيد تفاعلي.

خيارات مدمّرة: يحذف download --force جميع الملفات الموجودة في الدليل المستهدف، بما فيها الملفات غير المرتبطة. يرسل update مساحة العمل المحلية كاملة: يؤدي حذف ملف Episode إلى حذفه عن بُعد، كما يستبدل المحتوى المحلي القابل للتحرير المحتوى البعيد من دون التحقق من الإصدار أو الدمج. لا يمكن تحديث برامج Show التي يجري إنشاؤها أو إيقافها مؤقتاً.

reela show download <show-id> --out-dir ./my-show
cd my-show
reela show validate
reela show update --dry-run
reela show update

show subjectنسخ رابط العنوان

reela show subject download (--all | --subject-id <ID>) [--history] [--force]
reela show subject replace-image <SUBJECT_ID> --file <PATH>
reela show subject regenerate <SUBJECT_ID> --prompt-file <PATH> --model <MODEL> [--reference-image-id <ID>] [--yes]

• download: نزّل صور جميع Subjects أو Subject واحد في مساحة العمل الحالية. يتضمن --history الصور التاريخية؛ ويستبدل --force ملفات الصور الموجودة.
• replace-image: ارفع صورة ثابتة بصيغة JPEG أو PNG أو WebP (بحد أقصى 20 MiB و40 ميغابكسل)، مع الحفاظ على سجل الصور ومقاطع الفيديو الموجودة.
• regenerate: أنشئ صورة واحدة وانتظر حتى 10 دقائق. يجب أن يكون ملف المطالبة بترميز UTF-8. يختار --reference-image-id صورة من مساحة العمل الحالية؛ ويأذن --yes بالإنشاء من دون تأكيد تفاعلي.

تحتوي تنزيلات Show على ملفات منظّمة، لا على صور؛ نزّل صور Subject بصورة منفصلة. لاختيار صورة تاريخية، حرّر current_image_id في subjects.yaml، ثم حدّث.

لا يؤدي قطع إنشاء الصورة إلا إلى إيقاف الانتظار، وليس إنشاء الصورة في الخلفية. وقد يؤدي تشغيله مرة أخرى إلى إنشاء صورة وفرض رسوم مرة أخرى.

configنسخ رابط العنوان

أدِر الإعدادات وملفات تعريف الحسابات.

reela config list
reela config get <KEY>
reela config set <KEY> <VALUE>
reela config profiles list
reela config profiles create <NAME>
reela config profiles show [NAME]
reela config profiles use <NAME>
reela config profiles delete <NAME>

تُطبّق الإعدادات على الملف الشخصي المحدد. استخدم config list لاكتشاف المفاتيح والقيم الحالية. يغيّر profiles use الملف الشخصي الافتراضي؛ ويحدّد --profile ملفاً شخصياً لأمر واحد.

reela config set delivery.download ~/Videos/reela
reela config profiles create work
reela --profile work login
reela config profiles use work

daemon / subscribeنسخ رابط العنوان

أدِر التسليم التلقائي المحلي على Linux وmacOS. هذه الأوامر غير متاحة على Windows.

reela daemon start [--foreground] [--keep-backlog]
reela daemon stop
reela daemon status
reela daemon install
reela daemon uninstall
reela daemon logs [--tail <N>]

• start: ابدأ التسليم التلقائي. يُبقي --foreground البرنامج متصلاً بالطرفية. إذا لم يكن لهذا الملف الشخصي تقدم تسليم محفوظ، فإن --keep-backlog يسلّم أيضاً مقاطع الفيديو المكتملة سابقاً التي لا تزال متاحة للتسليم التلقائي. وإلا، يُستأنف التسليم من موضع التقدم المحفوظ.
• يوقف stop التسليم؛ ويعرض status حالته الحالية.
• يفعّل install بدء التشغيل عند تسجيل الدخول؛ ويعطّل uninstall بدء التشغيل التلقائي.
• يعرض logs السجلات الحديثة؛ ويعرض --tail 20 سطراً افتراضياً.

subscribeنسخ رابط العنوان

reela subscribe list
reela subscribe status
reela subscribe add download [--dir <DIR>]
reela subscribe add email [--address <EMAIL>]
reela subscribe add script --path <PATH> [--timeout-seconds <N>] [--max-retries <N>]
reela subscribe remove <METHOD>

الطرق هي download أو email أو script. يكون البريد الإلكتروني هو عنوان بريد الحساب افتراضياً. يجب أن يكون البرنامج النصي ملفاً تنفيذياً موثوقاً يقرأ كائن JSON واحداً من stdin وينتهي بالرمز 0 عند النجاح. --max-retries هو الحد الأقصى لإجمالي محاولات التسليم؛ استخدم reela subscribe add -h لحمولة البرنامج النصي.

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

reela subscribe add download --dir ~/Videos/reela
reela subscribe status

updateنسخ رابط العنوان

حدّث CLI المثبّت وتحقق من إصداره.

reela update
reela --version