Проекты

Проект содержит исходный медиаматериал, текст, настройки рендера и экспорты для караоке или lyric video. Проекты караоке также содержат разделённые стемы.

`project create`

Создайте новый проект из локального файла или URL.

youka project create <source> [options]

string

required

Путь к локальному файлу (./song.mp3) или HTTP/HTTPS URL (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>`	Модель разделения стемов
`--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 использует оригинальный аудиотрек без разделения на стемы и отклоняет --split-model. Если не указывать --kind, сохраняется поведение караоке.
--download подразумевает --export
--max-video-quality применяется только к HTTP/HTTPS URL-источникам. По умолчанию используется 1080p, выбирается лучшее доступное качество в пределах этого лимита и выполняется откат к лучшему доступному формату, когда платформа не предоставляет поток с ограничением по качеству.

`project list`

Выведите список всех проектов для аутентифицированного аккаунта.

youka project list
youka project list --json

`project quote`

Оцените количество кредитов, необходимых для создания проекта, не создавая проект.

youka project quote <source> [options]

source принимает те же формы пути к локальному файлу или HTTP/HTTPS URL, что и 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>`	Модель разделения стемов
`--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

ID проекта, возвращаемый командой 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]

Option	Description
`--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`

Выведите список стемов для проекта.

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 — рендер готового караоке
Presets — управление переиспользуемыми конфигурациями рендера
Render settings reference — общие поля пресетов и настроек

Возможности, версии и тайминги

youka capabilities --json возвращает ID моделей, поддерживаемые workflows, обработку текста, поддержку языков и доступность для аккаунта. Wav2Vec2 — модель выравнивания. ElevenLabs Scribe — модель транскрибации. Моделям, которым нужны изолированные вокалы, требуется karaoke workflow с моделью разделения, которая выдаёт 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 читает или обновляет выбранную версию. Если флаг опущен, используется основная версия. Импорт таймингов заменяет выравнивание целиком без processing job или удержания кредитов. Тело 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`

Что дальше

Возможности, версии и тайминги

​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

​Что дальше

​Возможности, версии и тайминги

`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`

Что дальше

Возможности, версии и тайминги