المشاريع

يحتوي المشروع على وسائط المصدر، والكلمات، وإعدادات التصيير، وعمليات التصدير لفيديو كاراوكي أو فيديو كلمات. كما تتضمن مشاريع الكاراوكي أيضًا المسارات الصوتية المفصولة (stems).

`project create`

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

youka project create <source> [options]

string

required

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

Options

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

Examples

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 كلمات
يستخدم --kind lyric-video الصوت الأصلي دون فصل المسارات (stems) ويرفض --split-model. إن إهمال --kind يُبقي سلوك الكاريوكي كما هو.
--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 نفس صيغ مسار الملف المحلي أو عنوان URL عبر HTTP/HTTPS كما في project create. بدون --duration، يرفع CLI المصدر لكي يتمكن الخادم من قياس الوسائط بدقة، لكنه لا ينشئ مشروعًا.

Options

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

Examples:

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، والمسارات (stems)، والإعدادات، والتصديرات.

youka project show <projectId>

string

required

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

`project wait`

استطلع حالة مشروع حتى يصل إلى حالة نهائية (terminal state).

youka project wait <projectId> --json

`project delete`

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

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

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

`project sync`

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

youka project sync <projectId> [options]

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

Example:

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

`project separate`

أعِد تشغيل فصل المسارات (stems) على مشروع موجود.

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

Example:

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 موجودًا، فسيُرجع الأمر الإعدادات الحالية. وإذا كان أحدهما موجودًا، فسيُجري تحديثًا. Examples:

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`

نزّل ملف stem واحدًا أو أكثر إلى القرص. تُنزَّل المسارات (stems) بصيغتها الأصلية المخزّنة؛ ولا يقوم CLI بإعادة ترميزها (transcode).

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 كأسماء بديلة.

What’s next

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

Capabilities, versions, and timings

يعيد youka capabilities --json معرّفات النماذج، وسير العمل المدعوم، ومعالجة النص، ودعم اللغات، وأهلية الحساب. Wav2Vec2 هو نموذج محاذاة. ElevenLabs Scribe هو نموذج تفريغ (transcription). النماذج التي تتطلب غناءً معزولًا تحتاج إلى سير عمل كاريوكي مع نموذج فصل ينتج مسار vocals.

youka capabilities --json
youka project create ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project quote ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project versions proj_example --json
youka project settings proj_example --version-id ver_example --json
youka project timings list proj_example --json
youka project timings get proj_example aln_example --json
youka project timings import proj_example aln_example --body corrected-request.json --json
youka project timings select proj_example aln_example --expected-revision "$ALIGNMENT_REVISION" --expected-selection-revision "$SELECTION_REVISION" --json

يقرأ project settings --version-id الإصدار المختار أو يحدّثه. إن إهمال الراية يستخدم الإصدار الأساسي. استيرادات التوقيت (timing) تستبدل المحاذاة بالكامل دون مهمة معالجة أو حجز اعتمادات. يحتوي جسم JSON على alignment وexpectedRevision. كما يتطلب الحفظ والاختيار الذري أيضًا select: true وexpectedSelectionRevision. يعيد الرمز المميّز القديم HTTP 409. اجلب القيم الحالية وقارنها قبل محاولة تعديل آخر. انظر Automate lyric videos لملفات الطلب، والتحقق من صحة التوقيت، ومعالجة الكتالوج القابلة للاستئناف.

Overview

How To

Customization

Audio

Settings

Exporting

Account

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

What’s next

Capabilities, versions, and timings

​project create

​Options

​Examples

​project list

​project quote

​Options

​project show

​project wait

​project delete

​project sync

​project separate

​project settings

​project stem list

​project stem download

​What’s next

​Capabilities, versions, and timings

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

What’s next

Capabilities, versions, and timings