المشاريع

المشروع هو مورد «قيد العمل» لمسار كاريوكي واحد. وهو يملك وسائط المصدر، الكلمات المتزامنة، المقاطع الصوتية المفصولة، إعدادات الإخراج، وعمليات التصدير التي يتم إنشاؤها منه.

`project create`

أنشئ مشروعًا جديدًا من ملف محلي أو من URL.

youka project create <source> [options]

string

required

مسار ملف محلي (./song.mp3) أو رابط HTTP/HTTPS (https://example.com/song.mp4).

الخيارات

الخيار	الوصف
`--title <title>`	عنوان المشروع
`--mode <mode>`	`none` أو `transcribe` أو `align`
`--lyrics <text>`	نص الكلمات
`--lang <code>`	رمز اللغة
`--sync-model <model>`	نموذج مزامنة الكلمات
`--split-model <model>`	نموذج فصل المقاطع الصوتية
`--max-video-quality <quality>`	أقصى جودة فيديو لمصادر URL: `720p` أو `1080p` أو `4k` أو `best`
`--preset <presetId>`	تطبيق إعداد مسبق أثناء إنشاء المشروع
`--export`	إنشاء تصدير بعد أن يصبح المشروع جاهزًا
`--download`	إنشاء تصدير، وانتظاره، ثم تنزيله
`--output <path>`	مسار الإخراج لـ `--download`

أمثلة

youka project create ./song.mp3 \
  --title "My Song" \
  --mode transcribe \
  --lang en \
  --wait \
  --json

youka project create "https://example.com/song.mp4" \
  --max-video-quality 4k \
  --download \
  --output ./karaoke.mp4 \
  --json

youka project create ./song.mp3 \
  --mode align \
  --lyrics "$(cat lyrics.txt)" \
  --sync-model audioshake-alignment \
  --wait \
  --json

القواعد:

إذا مرّرت كلمات وأهملت --mode، فإن CLI يضبط الافتراضي على align
align يتطلب كلمات
transcribe و none لا يقبلان كلمات
--download يتضمن ضمنيًا --export
ينطبق --max-video-quality فقط على مصادر URL عبر HTTP/HTTPS. القيمة الافتراضية هي 1080p، ويستخدم أفضل جودة متاحة حتى ذلك الحد، ويعود إلى أفضل صيغة متاحة عندما لا تتيح المنصة بثًا محددًا بسقف جودة.

`project list`

اعرض قائمة بجميع المشاريع للحساب الموثّق.

youka project list
youka project list --json

`project quote`

احسب عدد الاعتمادات المطلوبة لإنشاء مشروع دون إنشاء المشروع.

youka project quote <source> [options]

يقبل source نفس صيغ مسار الملف المحلي أو رابط HTTP/HTTPS كما في project create. بدون --duration، يقوم CLI برفع المصدر كي يتمكن الخادم من قياس الوسائط بدقة، لكنه لا ينشئ مشروعًا.

الخيارات

الخيار	الوصف
`--title <title>`	عنوان المشروع
`--mode <mode>`	`none` أو `transcribe` أو `align`
`--lyrics <text>`	نص الكلمات لـ `align`
`--lang <code>`	رمز اللغة
`--sync-model <model>`	نموذج مزامنة الكلمات
`--split-model <model>`	نموذج فصل المقاطع الصوتية
`--max-video-quality <quality>`	أقصى جودة فيديو لمصادر URL: `720p` أو `1080p` أو `4k` أو `best`
`--duration <seconds>`	احسب التكلفة اعتمادًا على مدة معروفة دون رفع المصدر

أمثلة:

youka project quote ./song.mp3 --mode transcribe --json
youka project quote https://example.com/song.mp4 --max-video-quality 4k --mode transcribe --json
youka project quote ./song.mp3 --duration 210 --mode none --json

`project show`

احصل على حالة المشروع الحالية، بما في ذلك state المُوحّدة، وpendingOperation، والمقاطع الصوتية، والإعدادات، وعمليات التصدير.

youka project show <projectId>

string

required

معرّف المشروع الذي أعاده project create.

`project wait`

استعلم عن المشروع دوريًا حتى يصل إلى حالة نهائية.

youka project wait <projectId> --json

`project delete`

احذف مشروعًا وجميع المقاطع الصوتية والكلمات وعمليات التصدير المرتبطة به.

youka project delete <projectId> --idempotency-key delete-<projectId>

الحذف نهائي. مرّر --idempotency-key لجعل إعادة المحاولة آمنة.

`project sync`

أعد تشغيل تفريغ الكلمات أو محاذاتها على مشروع موجود.

youka project sync <projectId> [options]

الخيار	الوصف
`--mode <mode>`	`transcribe` أو `align`
`--text <text>`	نص الكلمات
`--lang <code>`	رمز اللغة
`--sync-model <model>`	نموذج مزامنة الكلمات

مثال:

youka project sync $PROJECT_ID \
  --mode align \
  --text "$(cat lyrics.txt)" \
  --wait \
  --json

`project separate`

أعد تشغيل فصل المقاطع الصوتية على مشروع موجود.

youka project separate <projectId> [--split-model <model>]

مثال:

youka project separate $PROJECT_ID --split-model audioshakeai --wait --json

`project settings`

اقرأ إعدادات المشروع النشطة أو حدّثها.

youka project settings <projectId>
youka project settings <projectId> --preset <presetId> --body ./settings.json

إذا لم يكن --preset ولا --body موجودين، يعيد الأمر الإعدادات الحالية. إذا كان أحدهما موجودًا، فإنه ينفّذ تحديثًا. أمثلة:

youka project settings $PROJECT_ID --json

youka project settings $PROJECT_ID \
  --preset preset_abc123 \
  --body ./project-settings.json \
  --json

`project stem list`

اعرض قائمة بالمقاطع الصوتية (stems) لمشروع.

youka project stem list <projectId>
youka project stem list <projectId> --json

`project stem download`

نزّل ملفًا واحدًا أو أكثر من ملفات المقاطع الصوتية إلى القرص. يتم تنزيل المقاطع الصوتية بصيغتها الأصلية المخزنة؛ ولا يقوم CLI بإعادة ترميزها.

youka project stem download <projectId> <stemId> --output ./stems
youka project stem download <projectId> --type instrumental --output ./stems
youka project stem download <projectId> --type original --type backing-vocals --type vocals --output ./stems
youka project stem download <projectId> --all --output ./stems

القيم المدعومة لـ --type هي original وinstrumental وvocals و backing_vocals. كما يقبل CLI أيضًا backing-vocals وbackingVocals و backingvocals كأسماء بديلة.

ما التالي

Exports - إخراج (render) الكاريوكي النهائي
Presets - إدارة إعدادات إخراج قابلة لإعادة الاستخدام
Render settings reference - حقول الإعدادات والإعدادات المسبقة المشتركة

Overview

How To

Customization

Audio

Settings

Exporting

Account

`project create`

الخيارات

أمثلة

`project list`

`project quote`

الخيارات

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

ما التالي

​project create

​الخيارات

​أمثلة

​project list

​project quote

​الخيارات

​project show

​project wait

​project delete

​project sync

​project separate

​project settings

​project stem list

​project stem download

​ما التالي

`project create`

الخيارات

أمثلة

`project list`

`project quote`

الخيارات

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

ما التالي