الشروحات

PixVerse CLI: إنشاء فيديوهات وصور بالذكاء الاصطناعي من الطرفية

5 دقائق قراءة
آخر تحديث في
PixVerse CLI: إنشاء فيديوهات وصور بالذكاء الاصطناعي من الطرفية

مقدمة

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

يزيل PixVerse CLI عنق الزجاجة هذا. إنه واجهة سطر الأوامر الرسمية لـ PixVerse، ويمنحك الوصول إلى توليد PixVerse ومسارات عمل مساحة العمل مباشرة من طرفيتك. تحويل النص إلى فيديو، والصورة إلى فيديو، والنص إلى صورة، والصورة إلى صورة، والانتقالات، وتوليد الصوت، وتوليد الموسيقى، وفيديو المرجع، والتحكم في الحركة، والقوالب، وتحسين الدقة، وإدارة الأصول — كلها قابلة للبرمجة والربط بالأنابيب ومتاحة دون لمس المتصفح. لأقصر مسار تثبيت ونظرة عامة على إعداد الوكيل، ابدأ من صفحة PixVerse CLI الرسمية.

ما يجعل PixVerse CLI مفيدًا بشكل خاص هو فلسفة تصميمه: فقد بُني مع وضع وكلاء الذكاء الاصطناعي في الاعتبار. يمكن للأوامر إرجاع JSON منظم باستخدام --json أو -p، ورموز الخروج حتمية، وكل خطوة في خط الأنابيب قابلة للتركيب. وهذا يعني أنه يمكنك تعليم Claude Code أو Cursor أو Codex أو أي وكيل آخر إنشاء الصور والفيديوهات والصوت والموسيقى نيابة عنك مع عدد أقل من عمليات التسليم الهشة.

يتوافق هذا الدليل مع README الحالي لمستودع PixVerseAI/cli على GitHub وبيان الإمكانات العام وصفحة منتج PixVerse CLI، وتمت المراجعة في 13 يوليو 2026. يُحدَّث PixVerse CLI باستمرار عبر مستودع GitHub، لذا ينبغي لسكربتات الإنتاج أن تتحقق من pixverse --version وpixverse create <mode> --help وpixverse update قبل تشغيل دفعة كبيرة.

المتطلبات الأساسية

قبل البدء، تحتاج إلى:

  • Node.js 20 أو أحدث — تحقق باستخدام node --version
  • حساب PixVerse — سجّل في pixverse.ai
  • اشتراك PixVerse نشط — يستخدم CLI نظام الأرصدة نفسه المستخدم في الموقع؛ ولا يمكن إنشاء المحتوى إلا للمستخدمين المشتركين

لا يتطلب PixVerse CLI نسخ أي مفاتيح API يدويًا. تُدار المصادقة عبر تدفق OAuth قائم على المتصفح يخزن الرمز محليًا.

الخطوة 1: تثبيت CLI

ثبّت عالميًا باستخدام npm:

npm install -g pixverse

تحقق من التثبيت:

pixverse --version

إذا كنت تفضل عدم التثبيت عالميًا، يمكنك أيضًا تشغيل الأوامر عبر npx:

npx pixverse create video --prompt "A cat walking on Mars"

الخطوة 2: المصادقة

شغّل أمر تسجيل الدخول:

pixverse auth login

يفتح CLI متصفحًا لتفويض جهاز OAuth. يمكنك أيضًا نسخ عنوان URL وإكمال التفويض من أي متصفح على أي جهاز، وهو مفيد لبيئات SSH والبيئات بلا واجهة. يُخزَّن رمزك تلقائيًا في ~/.pixverse/ ويكون صالحًا لمدة 30 يومًا.

للتحقق من أنك مسجّل الدخول ومراجعة أرصدتك المتاحة:

pixverse auth status
pixverse account info
pixverse account slots

يعرض أمر account info مستوى اشتراكك وأرصدة مساحة العمل وسياق الاستخدام. يساعدك pixverse account usage على مراجعة استهلاك الأرصدة، بينما يعرض pixverse account slots فتحات التوليد المتزامنة الحالية لمهام الصورة والفيديو. جلسات CLI مستقلة عن جلسات ويب/تطبيق PixVerse، ويمكنك إزالة رمز CLI المخزّن باستخدام pixverse auth logout. تحقق دائمًا من رصيدك والفتحات المتاحة قبل تشغيل المهام الدفعية.

أوامر البدء السريع

إذا كنت تحتاج فقط إلى أقصر مسار من التثبيت إلى أصل مُولَّد، ابدأ بهذا التسلسل:

npm install -g pixverse
pixverse auth login
pixverse create image --prompt "A photorealistic forest path at golden hour" --json
pixverse create video --prompt "A sunset over ocean waves" --model v6 --quality 720p --duration 5 --json

لمسارات عمل الوكيل وCI، أبقِ --json أو -p مفعّلًا حتى يبقى stdout قابلًا للقراءة آليًا بينما يبقى التقدم والأخطاء على stderr. ولإعادة المحاولة في الإنتاج، أضف --idempotency-key <key> إلى أوامر الإنشاء حتى لا تنشئ الإرسالات المتكررة مهامًا مكررة تُخصم عليها الأرصدة عن طريق الخطأ.

الخطوة 3: إنشاء صورتك الأولى

توليد النص إلى صورة هو أسرع طريقة لاختبار إعدادك. شغّل:

pixverse create image --prompt "A photorealistic forest path at golden hour" --json

يذكر README الحالي على GitHub أن GPT Image 2 هو نموذج الصورة الافتراضي. للأتمتة القابلة لإعادة الإنتاج، عيّن --model صراحةً وتحقق من مساعدة CLI المباشرة أو capabilities.json قبل العمل الدفعي. يُرجع العلم --json مخرجات منظمة:

{
  "image_id": 789012,
  "status": "completed",
  "image_url": "https://...",
  "prompt": "A photorealistic forest path at golden hour",
  "model": "gpt-image-2.0",
  "width": 1440,
  "height": 1440
}

لمخرجات بدقة أعلى، حدد نموذجًا يدعمها:

pixverse create image \
  --prompt "A photorealistic forest path at golden hour" \
  --model seedream-5.0-lite \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json

تدعم PixVerse عدة نماذج صور، ولكل منها سقوف دقة مختلفة ودعم لنسب العرض إلى الارتفاع:

النموذج قيمة --model الجودة ملاحظات
GPT Image 2 gpt-image-2.0 1080p, 1440p, 2160p نموذج الصورة الافتراضي؛ يدعم نسب العرض العريضة والطويلة
Nano Banana 2 gemini-3.1-flash 512p, 1080p, 1440p, 2160p auto مرن ونسب عرض قياسية
Nano Banana 2 Lite gemini-3.1-flash-lite 1080p خيار Nano Banana 2 خفيف لمسارات الصور السريعة
Qwen Image qwen-image 720p, 1080p توليد سريع للمهام الإبداعية الشائعة
Nano Banana Pro gemini-3.0 1080p, 1440p, 2160p إنشاء صور عالي الجودة بأحجام أكبر
Nano Banana gemini-2.5-flash 1080p توليد صور خفيف مع إنجاز سريع
Seedream 5.0 Pro seedream-5.0-pro 1080p, 1440p يدعم نسب العرض القياسية ومسارات الصور متعددة المراجع
Seedream 5.0 Lite seedream-5.0-lite 1440p, 1800p, 2160p صور إبداعية عالية التفاصيل
Seedream 4.5 seedream-4.5 1440p, 2160p توليد صور عالي الدقة
Seedream 4.0 seedream-4.0 1080p, 1440p, 2160p خيار Seedream إضافي لمسارات الصور
Kling Image O3 kling-image-o3 1080p, 1440p, 2160p مخرجات بصرية منمّقة مع تأطير مرن
Kling Image V3 kling-image-v3 1080p, 1440p توازن بين الجودة والسرعة

يمكنك أيضًا تحويل صورة موجودة باستخدام الصورة إلى صورة:

pixverse create image \
  --prompt "Turn this product photo into a clean watercolor illustration" \
  --image ./product-photo.png \
  --model gpt-image-2.0 \
  --json

لتنزيل الصورة المُولَّدة:

pixverse asset download 789012

الخطوة 4: إنشاء فيديوك الأول

يعمل تحويل النص إلى فيديو بالطريقة نفسها. أنشئ مقطعًا مدته 5 ثوانٍ:

pixverse create video --prompt "A sunset over ocean waves" --json

لتوليد مخصص بالكامل:

pixverse create video \
  --prompt "A cinematic drone shot over a misty mountain valley at dawn" \
  --model v6 \
  --quality 1080p \
  --aspect-ratio 16:9 \
  --duration 8 \
  --audio \
  --json

يفعّل العلم --audio صوتًا محيطيًا مُولَّدًا بالذكاء الاصطناعي يطابق محتوى الفيديو. يُرجع العلم --json عند الاكتمال video_url يمكنك تمريره مباشرة إلى أمر تنزيل أو إلى الخطوة التالية في خط الأنابيب.

توفر PixVerse عدة نماذج فيديو بدعم مختلف للجودة والمدة والوضع:

النموذج قيمة --model أقصى جودة المدة ملاحظات
PixVerse V6 v6 1080p 1–15 ثانية نموذج الفيديو الافتراضي؛ دعم واسع لنسب العرض
PixVerse C1 pixverse-c1 1080p 1–15 ثانية دعم قوي عبر مسارات الفيديو والمرجع والانتقال
Seedance 2.0 Standard seedance-2.0-standard 2160p 4–15 ثانية يدعم أوضاع الفيديو والمرجع والانتقال
Seedance 2.0 Fast seedance-2.0-fast 720p 4–15 ثانية خيار Seedance أسرع لأوضاع الفيديو والمرجع والانتقال
Seedance 2.0 Mini seedance-2.0-mini 720p 4–15 ثانية خيار Seedance خفيف لأوضاع الفيديو والمرجع والانتقال
Google Gemini Omni gemini-omni-flash 720p 3–10 ثوانٍ يدعم مسارات الفيديو والمرجع بنسبة 16:9 أو 9:16
Happy Horse 1.0 happyhorse-1.0 1080p 3–15 ثانية خيار فيديو واعٍ للصوت متاح لـ create video
Kling O3 Pro kling-o3-pro 720p 3–15 ثانية يدعم مسارات الفيديو والمرجع والانتقال
Kling O3 Standard kling-o3-standard 720p 3–15 ثانية خيار Kling O3 القياسي
Kling 3.0 Pro kling-3.0-pro 720p 3–15 ثانية يدعم مسارات الفيديو والانتقال
Kling 3.0 Standard kling-3.0-standard 720p 3–15 ثانية خيار Kling 3.0 القياسي
Grok Imagine 1.5 grok-imagine-1.5 720p 1–15 ثانية من صورة إلى فيديو فقط؛ يتطلب --image ويتبع نسبة عرض الصورة المدخلة
Grok Imagine grok-imagine 720p 1–15 ثانية خيار Grok الأسبق؛ يدعم مسارات الفيديو والتمديد والمرجع
Veo 3.1 Lite veo-3.1-lite 1080p 4 أو 6 أو 8 ثوانٍ يدعم مسارات الفيديو وانتقال إطارين
Veo 3.1 Standard veo-3.1-standard 2160p 4 أو 6 أو 8 ثوانٍ خيار Veo بدقة أعلى
Veo 3.1 Fast veo-3.1-fast 2160p 4 أو 6 أو 8 ثوانٍ خيار Veo أسرع
Sora 2 Pro sora-2-pro 1080p 4 أو 8 أو 12 ثانية خيار Sora بمدد ثابتة
Sora 2 sora-2 720p 4 أو 8 أو 12 ثانية خيار Sora القياسي
PixVerse v5.6 v5.6 1080p 1–10 ثوانٍ لا يزال يُستخدم للتحكم في الحركة ومسارات توليد محددة
PixVerse v5.5 v5.5 1080p 1–10 ثوانٍ يُستخدم لمسارات create modify
PixVerse v5 v5 1080p 1–10 ثوانٍ يُستخدم لمسارات انتقال 3 إطارات أو أكثر

نماذج الشركاء مثل Seedance وKling وVeo وSora وGemini Omni وGrok Imagine وHappyHorse خيارات على PixVerse. استخدم سطح CLI نفسه لمقارنتها مع PixVerse V6 وC1.

تحريك صورة ثابتة

لتحويل صورة أو صورة مُولَّدة إلى فيديو، قدّم العلم --image:

pixverse create video \
  --prompt "Gentle wind moves through the scene" \
  --image ./product-photo.jpg \
  --model v6 \
  --quality 1080p \
  --json

يمكنك تمرير مسار ملف محلي أو عنوان URL. تُرفع الملفات المحلية تلقائيًا — دون خطوة رفع يدوية. تُغيَّر أبعاد مدخلات الصور المحلية الأكبر من 1920x1920 أو 5MB أو تُضغط تلقائيًا قبل الرفع؛ وتُتحقق عناوين URL للصور البعيدة من الواجهة الخلفية كما هي.

بالنسبة إلى Grok Imagine 1.5، الصورة مطلوبة وتتبع نسبة عرض المخرج تلك الصورة:

pixverse create video \
  --prompt "Slow camera push-in, subtle fabric motion, clean native ambience" \
  --image ./campaign-poster.png \
  --model grok-imagine-1.5 \
  --quality 720p \
  --duration 6 \
  --json

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

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

# Create a transition between keyframes
pixverse create transition --images ./frame1.png ./frame2.png

# Generate speech audio from text
pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3

# Generate music from a prompt
pixverse create music --prompt "A cinematic synth-pop intro with bright percussion" --auto-lyrics
pixverse create music --prompt "Uplifting piano theme for a product reveal" --instrumental --duration-seconds 60

# Extend a generated video
pixverse create extend --video <video_id>

# Modify an existing video
pixverse create modify --video <video_id> --prompt "Change the background to a beach"

# Upscale video resolution
pixverse create upscale --video <video_id> --quality 1080p

# Generate video with reference images
pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park"

# Seedance 2.0 reference can mix image and video inputs
pixverse create reference \
  --model seedance-2.0-standard \
  --images ./character.png \
  --videos ./motion.mp4 \
  --prompt "@image1 follows the motion in @video1"

# Seedance 2.0 models support up to 9 reference images
pixverse create reference \
  --model seedance-2.0-standard \
  --images ./char1.png ./char2.png ./char3.png ./char4.png \
  --prompt "@image1 and @image2 walk through the scene together"

# Motion control with a character image and motion reference video
pixverse create motion-control --image ./character.png --video ./dance.mp4

# Create from a template or effect
pixverse create template --template-id 12345 --image ./photo.png

لا يدعم كل نموذج كل وضع إنشاء. في مصفوفة README الحالية، يدعم create video كلاً من v6 وpixverse-c1 وSeedance 2.0 Standard/Fast/Mini وGoogle Gemini Omni وHappy Horse 1.0 وKling O3 وKling 3.0 وGrok Imagine وVeo 3.1 وSora 2 وv5.6. grok-imagine-1.5 من صورة إلى فيديو فقط ويتطلب --image؛ ويدعم create extend كلاً من v6 وgrok-imagine؛ ويدعم create reference كلاً من v6 وpixverse-c1 وSeedance 2.0 Standard/Fast/Mini وGoogle Gemini Omni وKling O3 وgrok-imagine وv5.6؛ وتدعم انتقالات الإطارين عائلات الفيديو الأحدث؛ وتستخدم انتقالات 3 إطارات أو أكثر v5؛ ويستخدم create modify v5.5؛ ويستخدم create motion-control v5.6.

الخطوة 5: توليد الصوت والموسيقى

يوثّق README الحالي على GitHub الصوت المستقل عبر أوامر إنشاء مخصصة. استخدم create voice لتحويل النص إلى كلام وcreate music لتوليد الموسيقى من الموجه. تُحفظ مخرجات الصوت والموسيقى كأصول صوتية، لذا يمكنك تتبعها باستخدام task وإدراجها باستخدام asset list --type audio وتنزيلها باستخدام asset download --type audio. لأجواء الفيديو الأصلية، استخدم --audio أو --no-audio في أوامر إنشاء الفيديو المدعومة.

توليد صوت الكلام:

pixverse create voice \
  --text "Welcome to the launch. Here is what changed this week." \
  --model speech-2.8-hd \
  --voice-id <preset_voice_id> \
  --output ./voiceover.mp3 \
  --json

تصفح نماذج الصوت والأصوات المعدة مسبقًا:

pixverse voice models --json
pixverse voice presets --model speech-2.8-hd --json

توليد الموسيقى:

pixverse create music \
  --prompt "A bright cinematic synth-pop track for a 30-second product reveal" \
  --auto-lyrics \
  --duration-seconds 30 \
  --json

للمقاطع الموسيقية الآلية، استخدم --instrumental. وللنماذج القادرة على الكلمات، مرّر الكلمات كنص حرفي أو مسار ملف محلي أو stdin:

pixverse create music \
  --prompt "Uplifting electronic pop with a confident chorus" \
  --lyrics ./lyrics.txt \
  --json

تشمل عائلات نماذج الصوت الحالية MiniMax Speech 2.8 ونماذج ElevenLabs. وتشمل عائلات نماذج الموسيقى الحالية MiniMax Music وElevenLabs Music وGoogle Lyria 3 Pro. استخدم pixverse voice models وpixverse music models للاطلاع على الكتالوج المباشر قبل برمجة سير عمل إنتاجي.

الخطوة 6: تشغيل المعالج التفاعلي

إذا كنت تستكشف للمرة الأولى ولم تتعرف بعد على كل الأعلام المتاحة، شغّل أي أمر إنشاء دون وسائط للدخول إلى المعالج الموجّه:

pixverse create video
pixverse create image

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

ما بعد التوليد: إدارة أصولك ومساحة العمل

يتضمن PixVerse CLI الحالي أيضًا أوامر إدارة تساعدك على بناء مسارات عمل طرفية شاملة:

  • pixverse task status <id> وpixverse task wait <id> لاستطلاع المهام
  • pixverse task status --ids 123,456,789 --type video --json لفحوصات حالة الدفعات
  • pixverse asset list وasset upload وasset info وasset download وasset delete لعمليات دورة حياة أصول الفيديو والصورة والصوت
  • pixverse saved list وsaved items وsaved new وsaved rename وsaved add وsaved remove وsaved delete للمجلدات المحفوظة
  • pixverse template categories وtemplate list وtemplate search وtemplate info لاكتشاف التأثيرات والقوالب
  • pixverse voice models وvoice presets وmusic models لاكتشاف نماذج الصوت المباشرة
  • pixverse workspace list وworkspace status وworkspace switch وworkspace manage لعمليات مساحات العمل المتعددة
  • pixverse account info وaccount usage وaccount slots لفحوصات الأرصدة والاستخدام والتزامن
  • pixverse config set وconfig list وconfig path وconfig defaults للإعدادات المحلية الافتراضية القابلة للتكرار

يجعل ذلك أتمتة الإنشاء والتنظيم واكتشاف القوالب واكتشاف الصوت والتنزيل وتوجيه مساحة العمل والتسليم في سكربت واحد أمرًا مباشرًا. إذا احتجت إلى تشغيل أمر واحد على مساحة عمل مختلفة، استخدم العلم العام --workspace-id <id>؛ ويستهدف 0 مساحة عملك الشخصية.

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

تعتمد معظم الأتمتة على مخرجات يمكن التنبؤ بها وسلوك تشغيل يمكن التنبؤ به. هذه الأعلام مفيدة بشكل خاص في السكربتات ومسارات عمل وكلاء الذكاء الاصطناعي:

العلم استخدمه من أجل
--json إرجاع مخرجات JSON منظمة
-p اسم مختصر لـ --json
--count <n> توليد 1–4 تنويعات من طلب واحد
--seed <number> جعل التوليد أسهل في إعادة الإنتاج
--off-peak استخدام تسعير خارج أوقات الذروة عند توفره
--audio / --no-audio تفعيل توليد الصوت أو تعطيله في أوامر الإنشاء المدعومة
--multi-shot / --no-multi-shot تفعيل وضع اللقطات المتعددة للفيديو أو تعطيله
--no-wait إرسال المهمة والعودة فورًا
--timeout <sec> تعيين مهلة الاستطلاع، والافتراضي 300 ثانية
--workspace-id <id> تجاوز مساحة العمل النشطة لأمر واحد
--trace-id <uuid> إرفاق UUIDv4 يقدمه المستدعي بطلبات API لتصحيح الأخطاء وإمكانية المراقبة
--idempotency-key <key> إعادة محاولة طلبات الإنشاء بأمان دون إنشاء مهام مكررة تُخصم عليها الأرصدة عن طريق الخطأ

أصبحت أعلام إدخال النص أسهل في الأتمتة. يمكن لـ --prompt و--text و--lyrics قبول سلسلة حرفية أو مسار ملف محلي أو - لـ stdin:

pixverse create video --prompt ./scene.txt --json
cat scene.txt | pixverse create image --prompt - --json
echo "Hello from the command line" | pixverse create voice --text - --json
pixverse create music --prompt "Bright synth-pop" --lyrics ./lyrics.txt --json

تعليم وكيل الذكاء الاصطناعي توليد الوسائط

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

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

تثبيت مهارات PixVerse

PixVerse Skills مكتبة مهارات منظمة تعلّم الوكلاء كيفية استخدام CLI بشكل صحيح: أعلام الأوامر وقيود النماذج وخطوط الأنابيب متعددة الخطوات ومعالجة الأخطاء القوية.

بالنسبة إلى Claude Code والوكلاء الآخرين الذين يدعمون صيغة المهارات، أضف مهارات PixVerse مباشرة:

npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generator

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

يشحن PixVerse CLI أيضًا بيان أوامر مضغوطًا قابلًا للقراءة آليًا في dist/capabilities.json، والمصدر العام متاح باسم capabilities.json في مستودع GitHub. يصف هذا البيان الأوامر والأعلام ورموز الخروج وتوقعات مخرجات JSON وفئات التأثيرات، حتى يتمكن الوكلاء من فحص عقد CLI دون كشط نص المساعدة.

بعد تحميل وكيك مهارات PixVerse، يمكنك إعطاؤه تعليمات بلغة طبيعية مثل:

  • «أنشئ فيديو عرض منتج مدته 10 ثوانٍ من لقطة الشاشة هذه»
  • «أنشئ أربع تنويعات لصورة غلاف هذه المدونة بتنسيق 16:9»
  • «حرّك هذا المخطط إلى مقطع شرح مدته 5 ثوانٍ مع صوت محيطي»
  • «أنشئ ثلاثة مقاطع ترويجية بتنسيق 16:9 مدة كل منها 8 ثوانٍ بحركات كاميرا مختلفة»

سيترجم الوكيل تلك التعليمات إلى أوامر CLI الصحيحة، ويحلل مخرجات JSON، ويتولى الاستطلاع والتنزيلات — دون الحاجة إلى تدخل يدوي.

Claude Code

في Claude Code، يصبح PixVerse CLI أداة أصلية يستخدمها الوكيل بشكل مستقل. بعد تحميل مهارات PixVerse، يمكنك تضمين توليد الوسائط مباشرة في أي مهمة:

أنشئ صورة غلاف لهذا المنشور عن التعلم الآلي، واستخدم نموذج seedream-5.0-lite بدقة 2160p وبتنسيق 16:9، ونزّلها إلى ./assets/cover.webp

سيستدعي Claude Code أوامر CLI الصحيحة، ويستخرج عنوان URL للصورة من استجابة JSON، وينزّل الملف إلى المسار الذي حددته — كل ذلك ضمن الجلسة نفسها التي يكتب فيها شيفرتك أيضًا.

سير عمل نموذجي في Claude Code:

# Claude Code runs this autonomously based on your instruction
IMG=$(pixverse create image \
  --prompt "Abstract visualization of neural network layers, dark background, blue and purple tones" \
  --model seedream-5.0-lite \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')

# Then animates it
pixverse create video \
  --prompt "Slow pan across glowing neural connections" \
  --image "$IMG" \
  --model v6 \
  --quality 1080p \
  --duration 6 \
  --json

Cursor

يمكن لمستخدمي Cursor تحميل PixVerse Skills كملف سياق للمشروع. ضع ملفات المهارة ذات الصلة في دليل .cursor/ أو أضفها إلى قواعد مساحة العمل. بعد التحميل، يمتلك Cursor وعيًا كاملًا بكل أمر في PixVerse CLI ويمكنه توليد الوسائط كجزء من أي مهمة برمجة.

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

Codex ووكلاء آخرون

يتوافق PixVerse CLI مع أي وكيل قادر على تنفيذ أوامر الصدفة وتحليل JSON. يضمن تنسيق الإخراج المنظم — بأسماء حقول متسقة ورموز أخطاء يمكن التنبؤ بها ورسائل أخطاء مفصولة عبر stderr — أن تتمكن حتى وكلاء البرمجة البسيطة من دمج التوليد بشكل موثوق.

يجعل عقد رمز الخروج معالجة الأخطاء أمرًا مباشرًا:

الرمز المعنى إجراء الوكيل
0 نجاح تحليل إخراج JSON
1 خطأ عام راجع stderr وأعد المحاولة بمدخلات مُتحقق منها
2 انتهاء المهلة أعد المحاولة مع --timeout أطول
3 انتهت صلاحية المصادقة أعد تشغيل pixverse auth login
4 نفاد الرصيد تحقق من الرصيد وأبلغ المستخدم
5 فشل التوليد جرّب معاملات مختلفة
6 خطأ في التحقق راجع قيم الأعلام

مسارات الأتمتة

بعد أن تفهم الأوامر الفردية، يفتح PixVerse CLI مسارات عمل متعددة الخطوات تعمل بالكامل دون تدخل المستخدم.

من النص إلى الصورة إلى الفيديو

من أكثر المسارات فائدة: توليد صورة عالية الدقة من موجه نصي، ثم تحريكها إلى فيديو.

# Step 1: Generate a base image
IMG_RESULT=$(pixverse create image \
  --prompt "A cyberpunk cityscape at night, neon lights reflecting on wet pavement" \
  --model gemini-3.1-flash \
  --quality 2160p \
  --aspect-ratio 16:9 \
  --json)

IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url')

# Step 2: Animate it into a video
VID_RESULT=$(pixverse create video \
  --prompt "Camera slowly pans across the neon-lit streets" \
  --image "$IMAGE_URL" \
  --model v6 \
  --quality 1080p \
  --duration 8 \
  --json)

VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id')

# Step 3: Download the final video
pixverse asset download "$VIDEO_ID" --json

مسار إنتاج فيديو كامل

للحصول على مخرجات مصقولة، اربط الإنشاء بخطوات ما بعد المعالجة. استخدم --audio أو --no-audio عندما تريد صوتًا أصليًا في أوامر إنشاء الفيديو المدعومة، ثم استخدم create voice لتحويل النص إلى كلام وcreate music لأصول موسيقية مستقلة ستجمعها لاحقًا:

# Step 1: Create the base video
RESULT=$(pixverse create video \
  --prompt "A product being assembled in slow motion" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --audio \
  --json)

VID=$(echo "$RESULT" | jq -r '.video_id')

# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --json | jq -r '.video_id')

pixverse task wait "$EXTENDED" --json

# Step 3: Upscale to 1080p
FINAL=$(pixverse create upscale \
  --video "$EXTENDED" \
  --quality 1080p \
  --json | jq -r '.video_id')

pixverse task wait "$FINAL" --json

# Step 4: Download
pixverse asset download "$FINAL" --json

# Optional: create a separate voiceover asset
pixverse create voice \
  --text "The final reveal starts now." \
  --voice-id <preset_voice_id> \
  --output ./voiceover.mp3 \
  --json

التوليد على دفعات

لمسارات المحتوى التي تتطلب عدة تنويعات، شغّل المهام بالتوازي:

# Check credits and concurrent generation slots first
pixverse account info --json
pixverse account slots --json

# Submit four parallel generations
pixverse create video --prompt "Sunrise over mountains" --no-wait --json > /tmp/v1.json &
pixverse create video --prompt "Sunset over ocean" --no-wait --json > /tmp/v2.json &
pixverse create video --prompt "Stars over a desert" --no-wait --json > /tmp/v3.json &
pixverse create video --prompt "Aurora over a frozen lake" --no-wait --json > /tmp/v4.json &
wait

# Check all returned task IDs in one batch status call
IDS=$(jq -r '.video_id' /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json | paste -sd, -)
pixverse task status --ids "$IDS" --type video --json

# Wait for each and download
for f in /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json; do
  ID=$(jq -r '.video_id' "$f")
  pixverse task wait "$ID" --json
  pixverse asset download "$ID" --json
done

يرسل العلم --no-wait المهمة ويعود فورًا بمعرّف المهمة، ما يتيح لك إرسال عدة مهام قبل بدء الاستطلاع. مع --no-wait --json، سجّل معرّفات المهام المُعادة ومعاملات الإنشاء المحسومة لأغراض التسجيل وإمكانية إعادة الإنتاج. استخدم --count <n> عندما تريد عدة تنويعات من موجه واحد، واستخدم الدفعة task status --ids عندما تريد استجابة حالة واحدة لعدة مهام قيد التشغيل. يتولى الأمر pixverse task wait الاستطلاع التكيفي نيابةً عنك.

ضبط الإعدادات الافتراضية

إذا كنت تستخدم النموذج أو الجودة أو نسبة العرض إلى الارتفاع نفسها باستمرار، فاضبطها كإعدادات افتراضية حتى لا تضطر إلى تكرار الأعلام في كل مرة:

pixverse config defaults set video model v6
pixverse config defaults set video quality 1080p
pixverse config defaults set image model seedream-5.0-lite
pixverse config set output-dir ~/Downloads/pixverse
pixverse config defaults show
pixverse config list
pixverse config path

تتجاوز أعلام سطر الأوامر دائمًا إعداداتك الافتراضية، فتحتفظ بمرونة كاملة مع تقليل التكرار. لأتمتة خاصة بمساحة عمل، أضف --workspace-id <id> إلى أمر عندما تريد تجاوز مساحة العمل النشطة لتلك العملية الواحدة.

ما يمكنك بناؤه

مع دمج PixVerse CLI في مسار عمل وكيلك، يتسع نطاق المهام القابلة للأتمتة بشكل ملحوظ:

  • التوثيق — ولّد تلقائيًا فيديوهات عرض المنتج ولقطات الشاشة ضمن عملية بناء وثائقك
  • التسويق — شغّل مهام دفعات ليلية تنتج تنويعات محتوى لوسائل التواصل من مكتبة موجهات واحدة
  • تطوير التطبيقات — دع وكيل البرمجة يولّد صورًا مؤقتة أو رسومًا متحركة للنماذج أو فيديوهات شاشة التحميل بينما تبني واجهة المستخدم
  • مسارات الصوت — ولّد مسودات تعليق صوتي أو مقاطع موسيقى من الموجه أو أصولًا صوتية للتحرير لاحقًا
  • مسارات المحتوى — اربط استدعاءات CLI بأدوات أخرى (ffmpeg وImageMagick والتخزين السحابي) لبناء مسارات إنتاج وسائط مؤتمتة بالكامل
  • النماذج الأولية — ولّد مفاهيم حركة سريعة خلال ثوانٍ للتحقق من الأفكار قبل الالتزام بالإنتاج الكامل

صُمم CLI ليندمج بشكل طبيعي في أي مسار عمل قائم على الصدفة. إذا كانت أتمتتك الحالية تعمل في bash أو Python أو Node أو مسار CI/CD، فإن PixVerse CLI يندمج دون أي عبء تكامل إضافي.

قائمة التحقق للبدء

  • ثبّت Node.js 20 أو أحدث
  • شغّل npm install -g pixverse
  • شغّل pixverse auth login وامنح الإذن في المتصفح
  • شغّل pixverse account info للتحقق من الرصيد
  • شغّل pixverse account slots قبل العمل المتزامن على دفعات
  • ولّد صورتك الأولى: pixverse create image --prompt "..." --json
  • ولّد فيديوك الأول: pixverse create video --prompt "..." --json
  • ولّد أول أصل صوتي: pixverse create voice --text "..." --json
  • ولّد أول أصل موسيقي: pixverse create music --prompt "..." --json
  • استكشف القوالب عبر pixverse template list
  • ثبّت PixVerse Skills لوكيلك (Claude Code أو Cursor أو Codex)
  • اضبط الإعدادات الافتراضية المفضلة عبر pixverse config defaults set
  • ابنِ أول مسار أتمتة

إبقاء CLI محدّثًا

استخدم أداة التحديث المدمجة لإبقاء CLI المحلي محدّثًا:

pixverse update

يمكنك أيضًا استخدام npm مباشرة:

npm install -g pixverse@latest

ولأن PixVerse CLI أداة تُحدَّث باستمرار وليس إطلاقًا لمرة واحدة، تعامل مع هذه المقالة كدليل ميداني عملي ومع المصادر الرسمية كطبقة المرجع الحي. صفحة PixVerse CLI الرسمية هي أقصر مسار للتثبيت وتهيئة الوكيل، بينما يبقى GitHub المكان المناسب لمتابعة تغييرات الإصدارات والنماذج المدعومة حديثًا:

تبرز الوثائق الحالية PixVerse V6 كنموذج الفيديو الافتراضي، وGPT Image 2 كنموذج الصورة الافتراضي، ودعم فيديو Google Gemini Omni، ودعم صور Nano Banana 2 Lite وSeedream 5.0 Pro، ودعم Seedance 2.0 Mini، ومسارات PixVerse v5 وv5.5 الخاصة بالأوضاع، وأوامر create voice وcreate music المخصصة، وإدارة الأصول الصوتية، والمجلدات المحفوظة، والتبديل بين مساحات العمل، وconfig defaults، وcapabilities.json للوكلاء، وpixverse update، ودعم stdin لمدخلات النص، و--trace-id، و--idempotency-key لإعادة المحاولة بأمان أكبر.

الخطوات التالية

تمنحك صفحة PixVerse CLI الرسمية وPixVerse CLI على GitHub وnpm (npm install -g pixverse) وصولًا فوريًا إلى التوليد واستطلاع المهام وإدارة الأصول والقوالب والمجلدات المحفوظة وفحوصات الحساب واكتشاف نماذج الصوت وعناصر التحكم في مساحة العمل من واجهة واحدة. يضيف مستودع PixVerse Skills إرشادات جاهزة للوكلاء حتى يتمكن Claude Code وCursor وCodex والأدوات الأخرى من تشغيل هذه المسارات بموثوقية أعلى.

يعني الجمع بين CLI موثوق ومكتبة مهارات جاهزة للوكلاء أن توليد الصور والفيديو والصوت والموسيقى يمكن أن يعيش في مسار العمل نفسه مع شيفرتك — يديره الوكيل نفسه، وفي الطرفية نفسها، دون التبديل بين الأدوات.

ابدأ بأمر واحد. ثم ابنِ انطلاقًا من هناك.

موارد ذات صلة

ولّد الفيديوهات والصور والصوت والموسيقى من طرفيتك مع PixVerse.