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

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

الخيارات

الخيار	الوصف
`--json`	وضع الآلة: اطبع غلاف JSON واحدًا فقط إلى stdout. يتم كتم السجلات ومؤشرات التقدم.
`--body <file\|->`	ادمج كائن JSON من ملف أو من stdin. تتغلب خيارات CLI على الحقول المطابقة القادمة من `--body`.
`--wait`	استطلع المورد الذي تم إنشاؤه حتى يصل إلى حالة نهائية. شائع في `project create` و`project sync` و`project separate` و`export create`.
`--idempotency-key <key>`	مرّر مفتاح عدم التكرار إلى واجهة برمجة التطبيقات في عمليات الكتابة.
`--quiet`	اكتم إخراج التقدم غير الخاص بـ JSON عند دمجه مع `--wait`.
`--no-color`	عطّل إخراج ألوان ANSI.
`--api <url>`	تجاوز عنوان URL الأساسي لواجهة برمجة التطبيقات. تتم إضافة اللاحقة `/ar/api/v1` تلقائيًا عند الحاجة.

غلاف JSON

مع --json، تكتب CLI غلافًا واحدًا فقط إلى stdout ولا شيء غير ذلك. النجاح:

{
  "ok": true,
  "data": {
    /* command result */
  }
}

الفشل:

{
  "ok": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid API key.",
    "details": null
  }
}

رموز الخروج:

الرمز	المعنى
`0`	نجاح.
`1`	خطأ وقت التشغيل (الشبكة، API، العرض).
`2`	إدخال غير صالح (خيارات خاطئة، حمولة غير مقروءة).

مرّر الغلاف عبر jq لأغراض السكربتات: youka project show $ID --json | jq '.data.state'.

تمرير أجسام JSON

يقبل أي أمر إنشاء أو تحديث الخيار --body لجسم الطلب بالكامل. استخدمه بدلًا من الهروب لكتابة JSON كبير على سطر الأوامر.

youka preset create --body ./preset.json --json

cat preset.json | youka preset create --body - --json

# CLI flag takes priority over matching fields from --body
youka preset create --body ./preset.json --name "Override name" --json

الانتظار للمهام غير المتزامنة

يقوم --wait باستطلاع المورد الذي تم إنشاؤه نيابةً عنك ويعيد الحالة النهائية. بدون --wait، تعود الأوامر بمجرد وضع المهمة في قائمة الانتظار.

youka project create ./song.mp3 --wait --json
youka export create $ID --wait --download --output ./out.mp4

اجمع --wait مع --quiet في السكربتات لكتم شريط التقدم مع الاستمرار في طباعة نتيجة JSON.

عدم التكرار

مرّر --idempotency-key لجعل أوامر الكتابة آمنة لإعادة المحاولة. إعادة استخدام المفتاح نفسه مع الحمولة نفسها تعيد النتيجة الأصلية بدلًا من إنشاء نسخة مكررة.

youka project create ./song.mp3 \
  --idempotency-key "import-2026-04-08-song-001" \
  --json

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

متغيرات البيئة

المتغير	الغرض
`YOUKA_API_KEY`	مفتاح API المستخدم عندما لا يتم تعيينه عبر `youka login`.
`YOUKA_API_BASE_URL`	عنوان URL أساسي بديل لـ API. يتم تجاوزه بواسطة `--api`.

ما التالي

الحساب - حفظ مفتاح API الخاص بك
المشاريع - أول سير عمل مكتوب بالسكربتات لديك
وكلاء الذكاء الاصطناعي - قواعد التشغيل لمؤلفي الوكلاء

Overview

How To

Customization

Audio

Settings

Exporting

Account

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