دليل PiAPI CLI السريع: إنشاء صور وفيديوهات AI من terminal
PiAPI CLI هو واجهة سطر الأوامر الرسمية من PiAPI. يتيح تشغيل نماذج AI متعددة الوسائط للصور والفيديو والصوت و3D وLLM مباشرة من terminal.
هذا الدليل السريع يشرح التثبيت، وتسجيل الدخول بمفتاح API، وتشغيل أول أمر لإنشاء صورة، وبدء مهمة فيديو async، واستكشاف النماذج المتاحة.
ما هو PiAPI CLI؟
تعريف سريع
PiAPI CLI هو أداة Node.js لسطر الأوامر لتشغيل نماذج PiAPI بدون فتح dashboard الويب.
AI CLI مفيد عندما يبدأ سير العمل من terminal: يمكنك حفظ الأمر، وإعادة تشغيله، وتعديل المعلمات، ودمجه في scripts أو AI agents.
- إنشاء assets من prompts قابلة للتكرار
- اختبار سريع أثناء بناء تطبيق أو prototype
- رفع ملفات محلية من مجلد المشروع
- حفظ النتائج في مجلد معروف
- إرجاع JSON للـ scripts أو CI أو agents
نظرة سريعة على PiAPI CLI
| الحزمة | piapi-cli |
|---|---|
| الأمر | piapi |
| Runtime | Node.js 18+ |
| الاستخدام الرئيسي | إنشاء AI متعدد الوسائط من terminal |
| مفيد لـ | المطورين والأتمتة وAI agents |
المتطلبات
- Node.js 18 أو أحدث
- PiAPI API key
- تطبيق terminal
تثبيت PiAPI CLI
ثبّت حزمة piapi-cli باستخدام package manager JavaScript الذي تفضله.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpالمصادقة باستخدام PiAPI API key
بعد التثبيت، اربط CLI بحساب PiAPI.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...إنشاء أول صورة AI من terminal
بعد المصادقة، يمكنك إنشاء صورة AI من terminal باستخدام piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024إنشاء أول فيديو AI من terminal
إنشاء الفيديو يستغرق وقتًا أطول عادة، لذلك يفضّل تشغيل نماذج الفيديو كمهام async.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>رفع ملفات محلية وتنزيل النتائج
يمكن لـ PiAPI CLI رفع ملفات محلية عندما يبدأ input بعلامة @، ثم تنزيل النتائج إلى المجلد الذي تختاره.
piapi run remove-bg image=@./photo.png --download --out-dir ./outاستكشاف النماذج والتحقق من quota
استخدم أوامر model لاستعراض النماذج وschema والتحقق من quota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaFlags مفيدة في PiAPI CLI
Flags مفيدة للأتمتة:
--async | خيار لسير عمل CLI |
--download | خيار لسير عمل CLI |
--out-dir <path> | خيار لسير عمل CLI |
--stream | خيار لسير عمل CLI |
--dry-run | خيار لسير عمل CLI |
--output json | JSON output for scripts and automation |
--webhook <url> | خيار لسير عمل CLI |
--quiet | خيار لسير عمل CLI |
--non-interactive | خيار لسير عمل CLI |
استخدام PiAPI CLI مع AI agents والأتمتة
يمكن استخدام PiAPI CLI أيضًا داخل AI agents وshell scripts وCI jobs وworkflows الأتمتة.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
حل مشكلات PiAPI CLI الشائعة
إذا لم يعمل الأمر الأول، افحص هذه المشكلات الشائعة قبل تغيير prompt أو model.
الأمر piapi غير موجود
npx piapi-cli@latest --help
API key مفقود أو غير صالح
piapi auth status
أمر الفيديو يعيد task ID بدل ملف
piapi task get <id>
متى تستخدم PiAPI CLI بدل Web UI؟
استخدم PiAPI CLI عندما تحتاج workflow قابلًا للتكرار أو scriptable أو مناسبًا لـ AI agent. Web UI مناسب للاستكشاف البصري، بينما CLI أفضل للأتمتة.
الأسئلة الشائعة
ما هو PiAPI CLI؟
PiAPI CLI هو أداة Node.js لسطر الأوامر لتشغيل نماذج PiAPI بدون فتح dashboard الويب.
كيف أثبّت PiAPI CLI؟
npm install -g piapi-cli / npx piapi-cli@latest --help
هل يمكن إنشاء صور وفيديوهات AI من terminal؟
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
ابدأ البناء باستخدام PiAPI CLI
يوفر PiAPI CLI طريقة عملية للمطورين وAI agents لإنشاء صور وفيديو وصوت و3D assets واستجابات LLM من سطر الأوامر.
