ولّد الصور والفيديو من الطرفية باستخدام OpenArt CLI

ما هو OpenArt CLI

OpenArt CLI هو ملف تنفيذي واحد يمنح طرفيتك وصولًا إلى OpenArt الحساب على macOS وLinux وWindows. تسجّل الدخول مرة واحدة عبر المتصفح مع openart login. يلغي مسار OAuth الحاجة إلى تثبيت Python أو Node، أو إنشاء مفتاح API، أو تخزين مفتاح طويل الأمد في النصوص البرمجية.

يستخدم أمر تسجيل الدخول تدفق OAuth القياسي مع PKCE، وهو نمط إعادة التوجيه عبر المتصفح نفسه الذي تستخدمه تطبيقات سطح المكتب لتجنّب التعامل مع كلمة المرور مباشرة. يخزّن CLI بيانات الاعتماد الناتجة في ~/.openart/cli-credentials.json (الوضع 0600، بحيث لا يمكن قراءته إلا لحساب المستخدم الخاص بك؛ ويخزّنه Windows في %USERPROFILE%\.openart\cli-credentials.json) ويحدّثه تلقائيًا. openart logout يُلغي بيانات الاعتماد ويمسح تلك الحالة المحلية.

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

ينفق CLI أرصدة حساب OpenArt الخاص بك، وهي المجموعة ذاتها التي يسحب منها تطبيق الويب. فهو ليس منتج API منفصلاً بمفتاح وفوترة خاصين به. أما مستودع OpenArt CLI على GitHub يحتوي على تعليمات التثبيت الرسمية، ومرجع الأوامر، وتفاصيل الإصدار الحالي.

كيفية تثبيت OpenArt CLI

يدعم OpenArt CLI أنظمة macOS وLinux وWindows كملف تنفيذي واحد مُجهّز مسبقًا. على macOS أو Linux، شغّل المثبّت الرسمي.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

على Windows، افتح PowerShell وشغّل المُثبِّت أحادي السطر.

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

يختار المُثبِّت البنية المناسبة لجهازك، ويتحقق منها مقابل مجاميع تحقق الإصدار، ويضع openart في دليل تنفيذي قياسي. على نظامي macOS وLinux، يستخدم /usr/local/bin عندما يكون ذلك الموقع قابلاً للكتابة أو ~/.local/bin لتثبيت على مستوى المستخدم، بدلاً من طلب sudo بشكل غير متوقع. إذا كان المثبّت يستخدم ~/.local/bin، تأكّد من أن ذلك المجلد موجود في PATH. على نظام Windows، يُثبَّت في %LOCALAPPDATA%\Programs\openart\bin ويضيف ذلك المجلد إلى مستخدمك PATH تلقائيًا، لذا لا حاجة إلى صلاحيات المسؤول.

يقبل كلا نصّي المثبّت موقع تثبيت مخصصًا أو إصدارًا مثبّتًا. على macOS أو Linux، أضف العلامات بعد النص البرمجي.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh -s -- --prefix "$HOME/.local" --version 0.1.0

لا يمكن لنص PowerShell المُمرَّر عبر الأنبوب أن يأخذ معطيات مباشرة، لذا اضبط الإصدار كمتغيّر بيئة أولاً.

$env:OPENART_VERSION = '0.1.0'
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

تفضّل عدم تمرير نص برمجي إلى الطرفية؟ نزّل الأرشيف الخاص بنظامك من أحدث إصدار (macOS بمعالج Apple silicon أو Intel، وLinux بمعمارية x86-64 أو arm64، وWindows بمعمارية x86-64 أو arm64)، واستخرجه، وضع openart على جهازك PATH. يأتي كل إصدار مع checksums.txt يمكنك التحقق باستخدام shasum -a 256 -c checksums.txt --ignore-missing.

للترقية لاحقاً، أعد تشغيل المثبّت نفسه. سيستبدل الملف التنفيذي الحالي في مكانه.

أكّد التثبيت في نافذة طرفية جديدة.

openart --help

ثم اربط واجهة سطر الأوامر بحساب OpenArt الخاص بك.

openart login

يفتح أمر تسجيل الدخول متصفحًا لمصادقة OAuth. بعد موافقتك على الوصول، يمكن لـ CLI استخدام حسابك دون مفتاح API أو بيئة تشغيل للغة مثل Python أو Node.

الأوامر الأساسية في لمحة

سطح الأوامر الأساسي

المصادقة والوصول إلى الحساب

يستخدم OpenArt مصادقة OAuth عبر المتصفح للوصول إلى الحساب. ابدأ جلسة باستخدام openart login، أنهِه بـ openart logout، وتحقّق من خطتك أو رصيدك باستخدام openart account.

openart login
openart account
openart logout

توليد الصور والفيديو

يُبقي OpenArt نوع الوسائط صريحًا في كل أمر توليد. افصل image و video تعني الأوامر أن السكربت لا يمكنه توجيه طلب إلى نوع النموذج الخاطئ عن طريق الخطأ.

لأجل توليد الصور من النص أو تحرير الصورة إلى صورة، استخدم أمر الصورة مع موجّه ومُعرّف نموذج. أضف --image عند توفير ملف محلي أو رابط URL كمرجع.

openart generate image "A ceramic mug on a studio table" \
  --model nano-banana-2 \
  -o ./out/

يستخدم المثال أعلاه nano-banana-2؛ استبدل بأي نموذج openart model list يعرض لك.

لأجل من النص إلى الفيديو أو من صورة إلى فيديو، استخدم أمر الفيديو. يمكن أن تشمل الخيارات المدعومة المدة ونسبة العرض إلى الارتفاع والدقة، حسب النموذج.

openart generate video "Slow camera orbit around the product" \
  --model kling-3-omni \
  --image ./start-frame.png \
  --duration 8

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

تتيح لك أوامر النماذج فحص الخيارات الحالية بدلًا من ترميز الافتراضات بشكل ثابت. openart model list يعرض النماذج المتاحة والأوضاع التي تدعمها. قد تتغير أسماء النماذج مع إضافة OpenArt خيارات جديدة.

openart model list
openart model cost
openart model cost --model nano-banana-2 --mode text2image
openart model form nano-banana-2 text2image

openart model cost وحده يعرض أسعار كل نموذج، الأرخص أولًا، دون إنفاق أي أرصدة. أضف --model و --mode لتسعير مجموعة محددة واحدة. أمر form يُرجع الأمر المعاملات الدقيقة التي يقبلها نموذج ووضع معين. إذا كنت تختار بين اثنين منها، فانظر كيف مقارنة GPT Image 2 مع Nano Banana 2 قبل أن تُسند إليه مهمة دفعية.

الإبداعات والأصول المخزّنة

تتيح أوامر الإنشاء للنصوص البرمجية فحص سجل التوليد وإدارة المهام المُرسَلة. استخدم list للإبداعات السابقة، get لمهمة واحدة، و wait عندما يتعين على سكربت التوقف حتى تنتهي مهمة غير متزامنة.

openart creation list --type video --limit 10
openart creation get <creation-id>
openart creation wait <creation-id>

تتحكم أوامر المشروع ومساحة العمل في المكان الذي ينتمي إليه العمل الجديد.

openart project list
openart project create --name "<name>"
openart workspace list
openart workspace select <workspace-id>
openart workspace select

workspace select بدون أي وسيط يعيدك إلى مساحة عملك الشخصية، و workspace list يميّز النشط منها بعلامة نجمية.

لملفات المرجع القابلة لإعادة الاستخدام، openart upload add <file> يرفع الأصل مرة واحدة ويطبع رابطًا للأوامر اللاحقة، و openart upload list --type image يعرض ما رفعته بالفعل. أمر مستودع CLI الرسمي يحتوي على مرجع الأوامر الحالي مع تطور الواجهة.

إلغاء التثبيت خطوة يدوية، لأن CLI لا يمتلك أمر إلغاء تثبيت مدمجاً. على macOS أو Linux، احذف الملف التنفيذي وبيانات اعتماده المخزّنة باستخدام rm "$(command -v openart)" و rm -rf ~/.openart. على Windows، احذف %LOCALAPPDATA%\Programs\openart، فأزلها من مستخدمك PATH، واحذف %USERPROFILE%\.openart. إذا واجهت خطأً يستحق الإبلاغ عنه، فأرفق مخرجات openart version في تقريرك. يُبلّغ عن البنية والنظام والالتزام بدقة.

أعلام مصممة للسكربتات، لا للنقرات

يوفّر OpenArt CLI أدوات تحكّم تجعل التوليد قابلاً للتنبؤ داخل النصوص البرمجية. كل واحدة منها تعالج مشكلة أتمتة شائعة: التحليل المنظّم، والإنفاق العرضي، والمهام طويلة التشغيل، والعمليات المتوقفة.

الـ --json تكتب العلامة نتائج قابلة للقراءة آليًا إلى المخرج القياسي. تذهب رسائل التقدم وترقيم الصفحات إلى الخطأ القياسي، بحيث يمكن لمهمة CI أو استدعاء أداة الوكيل توجيه JSON نظيف إلى أمر آخر دون استخراج نص قابل للقراءة البشرية. يمكن لنص برمجي استخراج معرّفات الإنشاء والحالات وروابط النتائج بشكل موثوق.

الـ --dry-run يطبع العلامة الطلب الدقيق الذي سيرسله OpenArt، لأي أمر من شأنه أن يكتب أو ينفق أرصدة، دون إرساله فعلياً. استخدمه لفحص خيارات النموذج والمعطيات قبل بدء حلقة دفعية، أو دع الوكيل يعاين أمراً مُنشأً قبل أن يُمنح إذن تنفيذ إجراء كتابة أو إنفاق.

الـ --async تقوم العلامة بإرسال عملية توليد وتعيد فورًا معرّف إنشائها بدلًا من الانتظار. يمكن لنص برمجي دفعي إرسال عدة مهام والقيام بأعمال أخرى ثم استخدام openart creation wait أو openart creation get لجمع النتائج. ولأن --async يعود قبل وجود ملف قابل للتنزيل، فلا يمكن دمجه مع -o أو --output.

بدون --async، يرسل OpenArt CLI المهمة ويستطلعها حتى تنتهي. يتوقف الاستطلاع عند --timeout، وقيمته الافتراضية خمس دقائق. يمنع الانتظار المحدود عمليةَ إنشاء فاشلة أو خللًا في الشبكة من ترك مهمة CI تعمل إلى ما لا نهاية، بينما يتيح لك تحديد مهلة صريحة استيعاب مهام الفيديو الأبطأ.

لماذا CLI وليس مجرد متصفح

سبقت واجهات سطر الأوامر الفأرة. عمل أول مُفسّر لسطر الأوامر على نظام CTSS في معهد MIT عام 1961، وتقليد كتابة النصوص البرمجية للأوامر الذي بدأه، والذي انتقل عبر أول شل في Unix عام 1971 وشل Bourne عام 1977، لا يزال الطريقة التي تُؤتمت بها معظم الخوادم وخطوط CI وأدوات المطورين اليوم (ويكيبيديا). شرح GitHub الرسمي يوضّح الفائدة العملية بجلاء: تُنجز واجهة سطر الأوامر مهمة بضغطات قليلة بدل سلسلة من النقرات، وتستهلك جزءاً يسيراً من موارد الواجهة الرسومية، وتحوّل العمل المتكرر إلى نص برمجي بدل خطوات يدوية متتالية.

تصبح هذه الحجة أقوى عندما يكون وكيل ذكاء اصطناعي، لا شخص، هو من يُصدر الأوامر. فنماذج LLM تعمل بالنص أساسًا، لذا فإن صيغة CLI القائمة على النص دخلاً وخرجًا تعني أن الوكيل لن يضطر أبدًا إلى تحليل لقطة شاشة لمعرفة ما إذا نجحت النقرة. فريق الهندسة في Parallel جادل بأن إجراءات CLI حتمية أيضًا وأرخص بكثير من أتمتة المتصفح المكافئة، إذ لا توجد صفحة لعرضها، ولا تخطيط لتفسيره، ولا غموض حول ما حدث بعد تشغيل الأمر. لا يمكن لـ Claude نفسه توليد الصور أو الفيديو، ولهذا السبب بالضبط يحتاج الوكيل إلى طريقة للوصول إلى نموذج قادر على ذلك. وهذا هو السبب ذاته الذي يجعل Claude Code وCodex يعاملان الطرفية كمساحة عمل لهما، وهو أيضاً سبب openart generate image ... أكثر ملاءمة لتلك الوكلاء من إدارة جلسة متصفح.

لا يزال المصطلح نفسه محل نقاش بين من يستخدمونه يوميًا. على r/AskProgramming، ناقش المطورون الفرق بين واجهة سطر الأوامر وبرنامج طرفية بملء الشاشة، أي TUI: فواجهة سطر الأوامر قائمة على الأسطر، إذ تكتب أمرًا وتتلقى ردًا قبل الانتقال إلى السطر التالي، بينما يعيد شيء مثل vim أو htop رسم الشاشة كاملةً ويتيح لك التنقل داخلها (r/AskProgramming). openart هو واجهة سطر أوامر بهذا المعنى الأضيق. كل أمر يُدخل في سطر واحد ويعيد نتيجة واحدة، وهو تمامًا الشكل الذي يتوقعه النص البرمجي أو الوكيل، وجزء من سبب عدم محاولته أن يكون لوحة تحكم تفاعلية.

CLI مقابل MCP: اختيار الواجهة المناسبة

يناسب OpenArt CLI سير العمل الذي يعمل بالفعل في الطرفية: النصوص البرمجية، والتوليد الدفعي، ومهام CI، والأتمتة القائمة على الشل حيث تغذّي الأوامر والمخرجات القابلة للقراءة آليًا الخطوة التالية.

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

OpenArt's خادم MCP يناسب العمل الإبداعي القائم على المحادثة داخل Claude (انظر مثال على توليد فيديو من Claude), ChatGPT، أو Cursor بدلًا من ذلك. يتيح MCP للوكيل استدعاء أدوات OpenArt أثناء الدردشة، وهو ما يناسب الطلبات التكرارية حيث تصف صورة أو فيديو وتحسّنه عبر المحادثة بدلًا من النص البرمجي. إذا كنت تقارن الخيارات على نطاق أوسع، فإليك كيف يتفوق مقارنة بـ خوادم MCP أخرى لتوليد الصور والفيديو.

لا يحل أي منهما محل تطبيق OpenArt على الويب. لا يزال تطبيق الويب هو الخيار الأنسب عندما تريد عناصر تحكم بصرية وفحصًا مباشرًا؛ بينما تخدم واجهة سطر الأوامر العمل الطرفي القابل للتكرار، وتخدم MCP التفاعل القائم على المحادثة. اختر الواجهة التي يجري فيها بقية عملك بالفعل: إذا كنت تختار بين CLI وMCP لوكيل تبنيه، اسأل نفسك هل يتحدث ذلك الوكيل إليك في نافذة محادثة (MCP) أم يعمل بلا إشراف في صدفة أو خط أنابيب (CLI).

البدء السريع: التثبيت وتسجيل الدخول والتوليد

على نظام macOS أو Linux، شغّل برنامج التثبيت.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

يمكن لمستخدمي Windows تشغيل مُثبِّت PowerShell بدلاً من ذلك.

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

بعد ذلك، صادق عبر نافذة المتصفح التي فتحها أمر تسجيل الدخول.

openart login

اعثر على نموذج صور حالي وانسخ معرّفه.

openart model list

استبدل النموذج في الأمر أدناه بمعرّف من تلك القائمة، مثل nano-banana-2. عاين طلبك الأول باستخدام --dry-run حتى لا ينفق OpenArt أي أرصدة.

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2 \
  --dry-run

بعد فحص المعاينة، أزل --dry-run لإرسال عملية التوليد.

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2

الأسئلة الشائعة

ما هو OpenArt CLI؟

OpenArt CLI هو ملف تنفيذي واحد لتوليد الصور ومقاطع الفيديو من الطرفية. يتصل بحساب OpenArt الخاص بك عبر OAuth المعتمد على المتصفح، ويمكنك استخدامه في النصوص البرمجية والمهام الدفعية ومهام CI ووكلاء البرمجة الذين يمتلكون وصولاً إلى الصدفة.

هل تثبيت OpenArt CLI مجاني؟

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

هل يتطلب OpenArt CLI مفتاح API؟

لا. openart login يفتح تسجيل دخول OAuth عبر المتصفح لحسابك في OpenArt، فلا تحتاج إلى تخزين أو تدوير مفتاح سري منفصل في الإعداد المحلي.

ما المنصات التي تدعم OpenArt CLI؟

macOS وLinux وWindows، ويُوزَّع كملف ثنائي مستقل عبر مستودع GitHub الرسمي. لست بحاجة إلى تثبيت Python أو Node.

CLI مقابل MCP: أيهما يجب أن أستخدم؟

استخدم CLI عندما يجري العمل بالفعل في الطرفية: النصوص البرمجية للأوامر، أو خطوط CI، أو وكيل برمجي مثل Claude Code أو Codex يملك صلاحية الوصول إلى الطرفية. واستخدم OpenArt خادم MCP عندما تريد وكيلًا قائمًا على المحادثة في Claude أو ChatGPT أو Cursor لإنشاء الصور أو الفيديو وتحسينها في أثناء المحادثة، كما تفعل إنشاء إعلانات المنتجات مباشرةً من Claude. فالاثنان لا يتعارضان؛ إذ تكتب بعض الفرق النصوص البرمجية للأجزاء القابلة للتكرار باستخدام CLI وتستخدم MCP للجزء الاستكشافي.

بمَ يختلف OpenArt CLI عن تطبيق الويب؟

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

كيف أُلغي تثبيت OpenArt CLI؟

لا يوجد أمر مدمج لإلغاء التثبيت، لذا أزل الملف الثنائي وبيانات الاعتماد المخزّنة يدويًا. شغّل rm "$(command -v openart)" و rm -rf ~/.openart على macOS أو Linux، أو احذف %LOCALAPPDATA%\Programs\openart و %USERPROFILE%\.openart على Windows.