الانتقال إلى المحتوى الرئيسي
تقوم Youka CLI بتغليف واجهة API العامة بحيث يمكنك إنشاء كاريوكي من أغنية، وتخصيص كلمات الأغنية ونمط الفيديو، وتصدير ملف MP4 نهائي من الطرفية لديك أو من وكيل (agent).

​
التثبيت

npm install -g @youka/cli
تحقّق من التثبيت: 
youka --version
youka --help

​
إعداد المصادقة

1

الحصول على مفتاح API

انتقل إلى online.youka.io/account، ثم افتح API keys، وانسخ مفتاحًا جديدًا.
2

حفظ المفتاح

ثبّت المفتاح في ~/.youka/config.json:
youka login YOUR_API_KEY
أو صدّره كمتغير بيئة:
export YOUKA_API_KEY=YOUR_API_KEY

​
إنشاء كاريوكي من ملف

استخدم ملف صوت أو فيديو محلي كمصدر: 
youka project create ./song.mp3 --download --output ./karaoke.mp4 --wait --json
سيؤدي ذلك إلى رفع المصدر، وإنشاء مشروع الكاريوكي، وتصوير (render) التصدير، ثم تنزيل فيديو MP4 النهائي.

​
إنشاء كاريوكي من رابط URL

مرّر رابط مصدر HTTP أو HTTPS بدلًا من مسار ملف: 
youka project create "https://example.com/song.mp4" --download --output ./karaoke.mp4 --wait --json
بالنسبة لروابط الفيديو المستضافة، تستخدم Youka أداة yt-dlp للتنزيل من الرابط. يمكنك تثبيت تبعيات تنزيل الروابط قبل أول عملية استيراد من URL: 
youka deps ensure --for url

​
مرجع

الحساب

سجّل الدخول، سجّل الخروج، وتفقّد حالة المصادقة.

الأرصدة

تفقّد الرصيد الحالي وحِزم الأرصدة التي ستنتهي صلاحيتها.

الفوترة

اعرض الأسعار وأنشئ روابط الدفع أو بوابة الحساب.

المشاريع

أنشئ المشاريع، افحصها، انتظر اكتمالها، وحدّثها.

عمليات التصدير

اعمل render لنتائج التصدير السحابية أو المحلية وقم بتنزيلها.

الإعدادات المسبقة

أدِر إعدادات render القابلة لإعادة الاستخدام.

الوسائط

ارفع الوسائط القابلة لإعادة الاستخدام وأدِرها.

المهام

افحص حالة المهام منخفضة المستوى عند الحاجة.

التبعيات

افحص وثبّت تبعيات استيراد URL وتبعيات الـ render المحلي.

الخيارات العامة

رايات (flags) متاحة على كل أمر.

​
جاهز للوكلاء افتراضيًا

يدعم كل أمر وضعًا مقروءًا آليًا يعيد ظرف JSON واحدًا بشكل ثابت. استخدم هذه الرايات للتحكم في CLI من الوكلاء أو السكربتات:
الرايةالغرض
--jsonاطبع ظرف JSON واحدًا تمامًا إلى stdout. يتم كتم التقدّم والسجلات.
--body <file|->ادمج حمولة JSON من ملف أو stdin. تتغلب رايات CLI على الحقول المطابقة.
--waitراقِب مهام async (إنشاء المشروع، عمليات التصدير) حتى تصل إلى حالة نهائية.
--idempotency-key <key>مرّر مفتاح idempotency لأي عملية كتابة.
--quietاكتم مخرجات التقدّم غير الخاصة بـ JSON عند استخدامها مع --wait.
--api <url>تجاوز عنوان URL الأساسي لواجهة API العامة.
شكل ظرف JSON: 
{
  "ok": true,
  "data": {
    /* command result */
  }
}
عند الفشل: 
{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Human-readable description",
    "details": {
      /* optional */
    }
  }
}
اطّلع على Global options للقائمة الكاملة.

​
التصدير السحابي مقابل التصدير المحلي

يعمل export create في السحابة افتراضيًا. مرّر --local لتشغيل render على جهازك باستخدام حزمة أدوات Remotion المدمجة. تتطلب عمليات الـ render المحلية تبعيات الـ render: 
youka deps ensure --for render
اطّلع على Exports لسير العمل الكامل.

​
ما التالي

  • Account - احفظ مفتاح API الخاص بك
  • Projects - أنشئ المشاريع وعالجها
  • Exports - اعمل render لفيديو كاريوكي نهائي
  • AI agents - شغّل CLI من سير عمل مؤتمت